home *** CD-ROM | disk | FTP | other *** search
/ Network CD 1 / Network CD.iso / ncomm / doc / ncomm.doc < prev    next >
Text File  |  1993-10-01  |  111KB  |  2,363 lines
  1.              NComm 3.0 - released the 1st of October, 1993
  2.  
  3.                                              //
  4.                 A terminal program for the \X/ AMIGA
  5.  
  6. ======================================================================
  7.  
  8. --- INDEX ---
  9.  
  10. 1.  INTRODUCTION
  11.  
  12.     1.1  ShareWare info        1.7  Manual info
  13.     1.2  Version Number        1.8  How to contact the author
  14.     1.3  Development info      1.9  Future expansion
  15.     1.4  History               1.10 Disclaimer
  16.     1.5  Credits               1.11 Summary of functions
  17.     1.6  Programming info
  18.  
  19. 2.  SETUP AND FILES USED
  20.  
  21.     2.1  Files included
  22.     2.2  Information about NComm Host Script
  23.     2.3  Change in file formats (upgrade info)
  24.     2.4  How to install new files
  25.     2.5  How to setup NComm: assignment
  26.     2.6  Using your own NewShell command
  27.     2.7  Sharing the serial port
  28.     2.8  Startup and command line option
  29.     2.9  Single-drive note
  30.     2.10 How to configure NComm for use with MBBS
  31.     2.11 A note about Ymodem-G and high speed modems
  32.     2.12 How to obtain high transfer rates with HST / V.32bis modems
  33.     2.13 Init string for TBK 9600+
  34.     2.14 Icon stack size
  35.  
  36. 3.  COMMANDS IN SYSTEM MENU
  37.  
  38.     3.1   Commands available   3.7.3 Save Macrokeys
  39.     3.2   About NComm          3.7.4 Leaving things unchanged
  40.     3.3   Status window        3.7.5 Installing new macrokeys
  41.     3.3.1 Send delay           3.8   Output to printer
  42.     3.3.2 Scrollback buffer    3.9   Starting a new Shell
  43.     3.4   Load configuration   3.10  Logging calls
  44.     3.5   Save configuration   3.11  Logging phone-info
  45.     3.6   Execute script       3.12  Setting Priority
  46.     3.7   Macrokeys window     3.13  ARexx Script
  47.     3.7.1 Control characters   3.14  Quit NComm
  48.     3.7.2 Load Macrokeys
  49.  
  50. 4.  COMMANDS IN FILE MENU
  51.  
  52.     4.1   Commands available   4.8.3 Kermit CD
  53.     4.2   ASCII capture        4.9   Protocol
  54.     4.3   ASCII send           4.9.1 Xmodem
  55.     4.4   Message upload       4.9.2 Ymodem
  56.     4.5   Download             4.9.3 Ymodem-Batch
  57.     4.6   Upload               4.9.4 Ymodem-G
  58.     4.7   Options              4.9.5 Zmodem
  59.     4.7.1 CRC                  4.9.6 Kermit
  60.     4.7.2 Chop files           4.9.7 Bimodem
  61.     4.7.3 G&R protocol         4.9.8 Bmodem Plus
  62.     4.7.4 G&R host mode        4.9.9 Compuserve-B
  63.     4.7.5 Zmodem resume        4.9.10 Jmodem
  64.     4.7.6 Zmodem autodl        4.9.11 VMS
  65.     4.7.7 Zmodem autoul        4.9.12 UUE-Ascii
  66.     4.7.8 Zmodem ack           4.9.13 External XPR
  67.     4.7.9 Zmodem bufsize       4.10  Default directory
  68.     4.7.10 Kermit host         4.11  Load scrollback buffer
  69.     4.7.11 Kermit 1k blocks    4.12  Save scrollback buffer
  70.     4.7.12 External XPR setup  4.13  View scrollback buffer
  71.     4.7.13 Create icons        4.14  Search in buffer
  72.     4.7.14 File comments       4.15  Save marked block
  73.     4.7.15 Transfer bar        4.16  Send marked block
  74.     4.8   Server Commands      4.17  Disable adding
  75.     4.8.1 Kermit Finish        4.18  Clear scrollback
  76.     4.8.2 Kermit Bye
  77.  
  78. 5.  COMMANDS IN SERIAL MENU
  79.  
  80.     5.1   Commands available   5.7.2 Xon / Xoff
  81.     5.2   Baud                 5.7.3 RTS / CTS
  82.     5.3   Data length          5.8   Set Device
  83.     5.4   Parity               5.9   Set Unit
  84.     5.5   Stop bits            5.10  Set Adjust Factor
  85.     5.6   Duplex               5.11  Shared Mode
  86.     5.6.1 Full duplex          5.12  Send Break
  87.     5.6.2 Half duplex          5.13  Serial Open
  88.     5.7   Handshaking          5.14  Set 75bps Delay
  89.     5.7.1 None
  90.  
  91. 6.  COMMANDS IN EMULATION MENU
  92.  
  93.     6.1    Commands available  6.3.11 IT7
  94.     6.2    End of line         6.3.12 SF7
  95.     6.3    Character set       6.3.13 DE7
  96.     6.3.1  ISO                 6.3.14 S87
  97.     6.3.2  IBM                 6.4    Del <-> BS
  98.     6.3.3  IBN                 6.5    Show HEX chars
  99.     6.3.4  IBP                 6.6    ANSI mouse
  100.     6.3.5  NO7                 6.7    ANSI capture
  101.     6.3.6  US7                 6.8    Destructive backspace
  102.     6.3.7  UK7                 6.9    Pad out blank lines
  103.     6.3.8  GE7                 6.10   Line wrap
  104.     6.3.9  FR7                 6.11   Line editing
  105.     6.3.10 SP7
  106.  
  107. 7.  COMMANDS IN SCREEN MENU
  108.  
  109.     7.1    Commands available  7.11   Workbench screen
  110.     7.2    Title bar           7.12   Close Workbench screen
  111.     7.3    ANSI pens           7.13   Text snapping
  112.     7.4    Screen mode         7.14   Force 80 x 24
  113.     7.5    Palette             7.15   Flashing text
  114.     7.6    Split screen        7.16   Custom Font
  115.     7.7    Style               7.17   Use WB Palette
  116.     7.8    Bell                7.18   Public Screen
  117.     7.9    Cursor blink        7.19   Window Gadgets
  118.     7.10   Reset
  119.  
  120. 8.  COMMANDS IN PHONE MENU
  121.  
  122.     8.1    Commands available  8.6.16 Redial delay
  123.     8.2    Phonebook           8.6.17 Use Locked rate
  124.     8.2.1  Dial                8.6.18 Drop-DTR hangup
  125.     8.2.2  Edit                8.6.19 Loop delay
  126.     8.2.3  New                 8.6.20 Hard-DCD Checking
  127.     8.2.4  Swap                8.6.21 Ignore echo
  128.     8.2.5  Load                8.6.22 Avoid blacklist
  129.     8.2.6  Save                8.6.23 Accepting the edit
  130.     8.2.7  Delete              8.7    Redial at logoff
  131.     8.2.8  Sort                8.8    Phonebook edit window
  132.     8.2.9  Print               8.8.1  Name
  133.     8.2.10 Clr/Mark            8.8.2  Phone #
  134.     8.3    Dial #              8.8.3  Comment
  135.     8.4    Hang up             8.8.4  Config
  136.     8.5    Redial              8.8.5  Macros
  137.     8.6    Modem setup         8.8.6  Script
  138.     8.6.1  Init string         8.8.7  ARexx
  139.     8.6.2  Exit string         8.8.8  Username
  140.     8.6.3  Dial cmd (1-4)      8.8.9  Password
  141.     8.6.4  Dial suffix         8.8.10  Baud rate
  142.     8.6.5  Hang-up string      8.8.11 Data length
  143.     8.6.7  Connect string      8.8.12 Parity
  144.     8.6.6  Disconnect string   8.8.13 Stop bits
  145.     8.6.8  Busy string         8.8.14 Duplex mode
  146.     8.6.9  Voice string        8.8.15 Character set
  147.     8.6.10 No dialtone string  8.8.16 Swap Del/Backspace
  148.     8.6.11 Error string        8.8.17 Transfer protocol
  149.     8.6.12 Ringing string      8.8.18 Show In Menu
  150.     8.6.13 No answer string    8.8.19 Dial Cmd
  151.     8.6.14 Remote ring string  8.8.20 Last dialled info
  152.     8.6.15 Delayed string      8.9    PB Password
  153.  
  154. 9. INFORMATION ABOUT DIAL MENU
  155.  
  156. 10. HOT KEYS AVAILABLE
  157.  
  158. ======================================================================
  159.  
  160.  
  161.  
  162. CHAPTER 1: INTRODUCTION
  163.  
  164. 1.1  NComm  V3.0  is  Shareware  -  it  isn't free, and all rights are
  165.      reserved.   You are not allowed to sell this program, and you may
  166.      only copy it for non-commercial purposes.  You may take a look at
  167.      the  program for free, but if you like it (or use it), you should
  168.      register.   Please  refer  to  the  Register.doc file for further
  169.      information about registering.
  170.  
  171.      If  you  want  to  distribute  NComm,  the program must be in its
  172.      original  archive  format,  including  all  documentation  files,
  173.      icons, scriptfiles, fonts, commands and libraries.
  174.  
  175.      NComm  is copyrighted, including copies which have been modified.
  176.      Any change to the executable or documentation is prohibited.  You
  177.      may  not modify, adapt, translate, reverse engineer, disassemble,
  178.      or decompile this program...
  179.  
  180.      Keep developers developing - future development depends on you...
  181.      The NComm development depends on ShareWare royalties and stops as
  182.      soon as we don't get any money for it.
  183.  
  184. 1.2  NComm  version 3.0 was written by Torkel Lodberg.  It is based on
  185.      NComm 1.9 by Daniel Bloch & co.
  186.  
  187. 1.3  This  program  was  developed  using SAS C and is the result of a
  188.      project  started  in  Oslo in 1988, using the Rodeløkka (M)BBS to
  189.      coordinate the initial efforts.
  190.  
  191. 1.4  History
  192.      =================================================================
  193.      Many  of  the  communication  programs on the market today *look*
  194.      nice,  but after testing them for a few minutes you find out that
  195.      they  are  so bug-ridden that even the old Basic-program you used
  196.      on the Commodore 64 would be preferable.
  197.  
  198.      We  thought  that  no  Amiga  communication program fulfilled our
  199.      needs,  and  figured  out that the only way to get a program that
  200.      did  everything we wanted, was to make it ourselves!  Luckily the
  201.      source  for  Comm  1.34  was  available.   It  had  all the basic
  202.      functions,  so  we  could  concentrate  on  what  we  thought was
  203.      missing.
  204.  
  205.      Our  goal  wasn't  to  make a program with a lot of functions you
  206.      never  use,  but with the functions that we needed - and they had
  207.      to   work!    Our  national  characters  have  been  ignored  and
  208.      mistreated, but NComm puts an end to that.
  209.  
  210. 1.5  The  project  was  led by Daniel Bloch, and chief contributors to
  211.      the design so far, apart from Daniel, have been:
  212.  
  213.      Trym Hansen         Conrad Helgeland      Torkel Lodberg
  214.      Jørn Lokøy          Per Hansen            Geir Atle Storhaug
  215.      Arvid Johansen      Geir Inge Høsteng     Anders Herbjørnsen
  216.      Bjørn Melbye        Eric Wheatley         Marek Rzewuski
  217.      Heiko Schlichting   Miguel Casteleiro     Øyvind Harboe
  218.      Thomas Baetzler     Nils-Arne Dahlberg    Roger Nordin
  219.  
  220.      Thanks   go   to  Mike  Robertson  (who  gave  us  the  necessary
  221.      information  for  the  G&R protocol, and helped us out with a few
  222.      other  things)  and Dj James (for the source to Comm 1.34).  Also
  223.      thanks  to  all the Beta-testers.  Feedback from the users is the
  224.      most important thing when developing a program!
  225.  
  226.      The  XPR spec. was  created  by Willy Langeveld. NComm would have
  227.      been nothing without it...
  228.  
  229.      Phone icon created by Bjørn Rybakken.  He also made the new NComm
  230.      fonts - thanks!
  231.  
  232. 1.6  All  changes  since  V1.9  were made by Torkel Lodberg, so please
  233.      don't  blame  Daniel  Bloch  if you find any bugs or simply don't
  234.      like the new version :-)
  235.  
  236. 1.7  This  manual  was  written  by  Torkel  Lodberg,  with  help from
  237.      Conrad Helgeland and Eric Wheatley.
  238.  
  239. 1.8  We  welcome  bug  reports  and  comments  about  NComm  and   the
  240.      documentation.  Send your comments to this address:
  241.  
  242.         Torkel Lodberg, Pilotveien 10, N-0384 Oslo 3, Norway.
  243.         Internet email: torkel@scala.adsp.sub.org
  244.  
  245.      Or call: Rodeløkka (M)BBS at 300-19200 baud, 24hrs, two nodes.
  246.  
  247.               Phone # +47 22 380949 (international) (V32/V42bis/PEP)
  248.                           22 380949 (Norway)
  249.  
  250. 1.9  A  probable  future  expansion  is  the  addition of a better and
  251.      faster  internal  terminal emulation.  External emulation support
  252.      (XEM)  is  also  one  of  the  things  we would like to add.  New
  253.      XEM / XPR libraries are especially welcome and can be sent to the
  254.      address above...
  255.  
  256.      A  final  note:  Please read this documentation carefully.  Most
  257.      things should be explained here.
  258.  
  259. 1.10 Disclaimer:
  260.      -----------
  261.      We  have  made  every  effort  possible to ensure that NComm will
  262.      function  as described, but no warranty of any kind, expressed or
  263.      implied, is  made by us.  We will not be liable for any direct or
  264.      indirect  damages  to  either machinal equipment or mental health
  265.      arising  from  a  failure of the program to operate in the manner
  266.      desired  by the user.  In no event will we be liable for any loss
  267.      of profits or savings.
  268.  
  269. 1.11 Summary of functions:
  270.  
  271.         o Works on any Amiga with 1MB RAM or more. Menu driven.
  272.         o Full support for all AmigaDOS 2.0 and 3.0 functions,
  273.           including Screen Mode settings, Public Screens, Shanghai
  274.           Windows and Interleaved Bitmaps. Full 2.0 look.
  275.         o ANSI / VT100 terminal emulation with full 8 colour text
  276.           support. IBM graphics (optional). Optional translation of
  277.           styles. Interlaced screen (optional). PAL, NTSC and overscan
  278.           support. Can be run on WB screen. Flashing text.
  279.           80 x 24 option. Automatic ANSI detection. Optional line wrap.
  280.           Custom font support. Optional line editing.
  281.         o Full support for all European languages (both character-
  282.           sets and keymaps). Thirteen translation modes.
  283.         o Baud rates up to 115200 baud supported (31250 baud on a M68000-
  284.           Amiga). Xon/Xoff and CTS/RTS handshaking. Fast screen I/O.
  285.           Optional shared mode. Adjust option. DTR hangup option.
  286.           1200/75 support. LockSerial support. All paritys supported.
  287.           Half duplex option. User settable device and unit number.
  288.         o Fast file transfer protocols:  ASCII, Xmodem, Xmodem-CRC,
  289.           Ymodem, Ymodem-Batch, Ymodem-G (for error correcting modems).
  290.           Fast Zmodem and Kermit, Bimodem, Bmodem Plus, Jmodem, Compuserve
  291.           Quick-B, VMS and Uue-ASCII protocols using external libraries.
  292.           Full support for custom XPR libraries.
  293.           Autochop on receive files - disabled for ARC, ZOO, PAK, ZIP.
  294.           Optional translation. Batch uploads and downloads. Optional icon
  295.           creation. Filenote option.
  296.         o Autodownload feature for MBBS or systems with G&R protocol.
  297.           G&R host mode. Zmodem autodownload and autoupload features
  298.           for use with any system.
  299.         o A very powerful inbuilt script language - simple text language
  300.           automates sessions. Full support for variables and arithmetics.
  301.           Advanced Host-Mode script follows program.
  302.         o An ARexx interface with access to all script and menu commands.
  303.         o Optional scrollback buffer - view, save or paste text that
  304.           previously has been displayed on screen. Block functions.
  305.           Real-time scrolling. Search function. Settable scrollback size
  306.           from 8K to 512K.
  307.         o Hot Keys for most program functions, including dialing of
  308.           up to 10 phone numbers.
  309.         o Split screen mode for conferencing.
  310.         o Dialing directory, queued dial, redial until carrier
  311.           received. Redial at logoff. Support for all kind of modems.
  312.           Optional multiple init string. "Avoid blacklist" feature.
  313.         o 46 entry fast phonemenu. Advanced phone requester with
  314.           unlimited entries. Optional password protection.
  315.         o 24 keyboard macros using function and cursor keys.
  316.         o Optional real time printing of incoming text.
  317.         o Log writes. Automatically records when you were last on system.
  318.         o Nodelist support via traplist.library.
  319.         o Clipboard support. NComm sends the contents of the clipboard
  320.           to the serial port when pressing Right-Amiga-V and using ConClip.
  321.         o Internal multitasking.
  322.  
  323. CHAPTER 2: PREPARATION
  324.  
  325. 2.1  The following files should be included in this package:
  326.  
  327.      :NComm
  328.      d---arwxd   Mar  6  1993     0        0 CpuBlit
  329.      d----rwxd   Oct  1 00:04     0        0 Doc
  330.      d----rwxd   Sep 24 13:22     0        0 fonts
  331.      d----rwxd   May 31 20:17     0        0 Host
  332.      d----rwxd   Sep 29 10:20     0        0 libs
  333.      d----rwxd   Sep 25 16:13     0        0 Scripts
  334.      -----rwxd   Sep 27 00:56     2     1011 Install13
  335.      -----rwxd   Sep 27 00:54     2     1012 Install20
  336.      -----rwxd   Oct  1 00:07   416   212944 NComm
  337.      -----rwxd   Sep 29 18:26     4     1929 NComm.config
  338.      ----arwxd   Mar  6  1993     1       17 NComm.keys
  339.      -----rwxd   Sep 29 23:54   144    73498 NComm.news
  340.      -----rwxd   Sep 24 13:17     1      343 NComm.phone
  341.      -----rwxd   Sep 26 11:54     4     1929 NCommANSI.config
  342.      -----rwxd   Oct  1 00:03    10     4932 Register.doc
  343.      Dirs:6    Files:9    Blocks:584   Bytes:297568
  344.  
  345.      :NComm/CpuBlit
  346.      ----arwxd   Mar  6  1993    15     7232 CpuBlit
  347.      Dirs:0    Files:1    Blocks:15    Bytes:7232
  348.  
  349.      :NComm/Doc
  350.      -----rwxd   Sep 29 14:02    35    17889 ARexx.doc
  351.      ----arwxd   Mar  6  1993    28    14030 CpuBlit.doc
  352.      -----rwxd   May 31 20:28    42    21368 Host.doc
  353.      -----rwxd   Oct  1 00:04   218   111226 NComm.doc
  354.      -----rwxd   Sep 29 14:04    61    31103 Script.doc
  355.      Dirs:0    Files:5    Blocks:384   Bytes:195604
  356.  
  357.      :NComm/fonts
  358.      d----rwxd   Sep 24 13:22     0        0 Ibm5
  359.      d---arwxd   Mar  6  1993     0        0 NComm1
  360.      d---arwxd   Mar  6  1993     0        0 NComm2
  361.      -----rwxd   Sep 24 13:22     1      264 Ibm5.font
  362.      ----arwxd   Mar  6  1993     1      264 NComm1.font
  363.      ----arwxd   Mar  6  1993     1      264 NComm2.font
  364.      Dirs:3    Files:3    Blocks:3     Bytes:792
  365.  
  366.      :NComm/fonts/Ibm5
  367.      -----rwxd   Sep 24 13:22     7     3208 8
  368.      Dirs:0    Files:1    Blocks:7     Bytes:3208
  369.  
  370.      :NComm/fonts/NComm1
  371.      ----arwxd   Mar  6  1993     6     2616 8
  372.      Dirs:0    Files:1    Blocks:6     Bytes:2616
  373.  
  374.      :NComm/fonts/NComm2
  375.      ----arwxd   Mar  6  1993     2      572 8
  376.      Dirs:0    Files:1    Blocks:2     Bytes:572
  377.  
  378.      :NComm/Host
  379.      d---arwxd   Mar  6  1993     0        0 Bulletins
  380.      d---arwxd   Mar  6  1993     0        0 Ckomm
  381.      d---arwxd   Mar  6  1993     0        0 Files
  382.      d---arwxd   Mar  6  1993     0        0 Hold
  383.      d---arwxd   Mar  6  1993     0        0 Menus
  384.      d---arwxd   Mar  6  1993     0        0 Msgs
  385.      ----arwxd   Mar  6  1993     1      191 a.script
  386.      ----arwxd   Mar  6  1993     1       53 CharSets
  387.      ----arwxd   Mar  6  1993     1      326 FirstUser
  388.      ----arwxd   Mar  6  1993     3     1297 host.config
  389.      -----rwxd   May 31 20:17    90    45927 Host.script
  390.      ----arwxd   Mar  6  1993     1      237 logout
  391.      ----arwxd   Mar  6  1993     1      134 newuser
  392.      ----arwxd   Mar  6  1993     1      206 postlog
  393.      ----arwxd   Mar  6  1993     1      432 prelog
  394.      ----arwxd   Mar  6  1993     1       62 TransProtos
  395.      ----arwxd   Mar  6  1993     1       11 TransProtosS
  396.      Dirs:6    Files:11   Blocks:102   Bytes:48876
  397.  
  398.      :NComm/Host/Bulletins
  399.      ----arwxd   Mar  6  1993     1       53 Bull0
  400.      ----arwxd   Mar  6  1993     4     1835 Bull1
  401.      ----arwxd   Mar  6  1993     1       46 Bull2
  402.      Dirs:0    Files:3    Blocks:6     Bytes:1934
  403.  
  404.      :NComm/Host/Ckomm
  405.      ----arwxd   Mar  6  1993     1       58 README
  406.      Dirs:0    Files:1    Blocks:1     Bytes:58
  407.  
  408.      :NComm/Host/Files
  409.      ----arwxd   Mar  6  1993     1       43 Readme
  410.      Dirs:0    Files:1    Blocks:1     Bytes:43
  411.  
  412.      :NComm/Host/Hold
  413.      ----arwxd   Bad Date!        1       55 Boringtown BBS
  414.      Dirs:0    Files:1    Blocks:1     Bytes:55
  415.  
  416.      :NComm/Host/Menus
  417.      ----arwxd   Mar  6  1993     4     1568 allmenu
  418.      ----arwxd   Mar  6  1993     1      297 menu0
  419.      ----arwxd   Mar  6  1993     1      410 menu1
  420.      ----arwxd   Mar  6  1993     1      198 menu2
  421.      ----arwxd   Mar  6  1993     1      304 menu3
  422.      ----arwxd   Mar  6  1993     1      186 menu4
  423.      ----arwxd   Mar  6  1993     1      208 menu5
  424.      Dirs:0    Files:7    Blocks:10    Bytes:3171
  425.  
  426.      :NComm/Host/Msgs
  427.      ----arwxd   Mar  6  1993     1      286 Messages1
  428.      ----arwxd   Mar  6  1993     1        0 Messages2
  429.      ----arwxd   Mar  6  1993     1      144 README
  430.      Dirs:0    Files:3    Blocks:3     Bytes:430
  431.  
  432.      :NComm/libs
  433.      -----rwxd   Sep 29 10:20    77    39000 reqtools.library.os13
  434.      -----rwxd   Sep 29 10:20    78    39588 reqtools.library.os20
  435.      ----arwxd   Mar  6  1993    38    19104 xprkermit.library
  436.      ----arwxd   Mar  6  1993    40    20172 xprzmodem.library
  437.      Dirs:0    Files:4    Blocks:233   Bytes:117864
  438.  
  439.      :NComm/Scripts
  440.      -----rwxd   Apr 24 14:03     1      275 clock.script
  441.      -----rwxd   May 24 09:45     2      678 couchrx.ncomm
  442.      -----rwxd   Apr 24 14:01     1      385 count.script
  443.      ----arwxd   Mar  6  1993     2      838 mbbs.script
  444.      -----rwxd   Sep 25 16:13     1      417 random.script
  445.      -----rwxd   May 24 09:43     1      473 rxread1.ncomm
  446.      -----rwxd   May 24 09:43     2      740 rxread2.ncomm
  447.      ----arwxd   Mar  6  1993     2      879 rxread3.ncomm
  448.      ----arwxd   Mar  6  1993     2      682 testrx.ncomm
  449.      Dirs:0    Files:9    Blocks:14    Bytes:5367
  450.  
  451.      Be  careful  not  to  mix these files with old Comm 1.34 or NComm
  452.      1.01  files   that  may  be  lying  around.   The  datafiles  are
  453.      incompatible.
  454.  
  455. 2.2  Read  the  file  'host.doc'  for information about the NComm Host
  456.      Script.
  457.  
  458. 2.3  The NComm.config format has been changed since NComm 1.8.  If you
  459.      haven't  used  V1.9,  all  configuration files should be deleted!
  460.      The same thing goes for V1.8 phonebooks.
  461.  
  462. 2.4  NComm  uses  two  fonts  for  emulating  IBM graphics.  They must
  463.      reside  in  the  directory  named  FONTS:.   NComm  also uses two
  464.      external  protocol libraries for supporting Kermit and Zmodem.  A
  465.      Requester  Library is being used for many of the requesters.  All
  466.      of these files must be installed before NComm can be used.
  467.  
  468.      To  install  NComm  on  a  1.2  / 1.3 system, enter the following
  469.      command in Shell (or click on the Install13 icon from WorkBench);
  470.  
  471.      1> Execute Install13
  472.  
  473.      To  install  NComm  on  a  2.0  / 3.0 system, enter the following
  474.      command in Shell (or click on the Install20 icon from WorkBench);
  475.  
  476.      1> Execute Install20
  477.  
  478.      This  batchfile  will  copy  the  font files used by NComm to the
  479.      FONTS:   directory.  First  (of course) you have to assign FONTS:
  480.      to  the  directory  where you keep your fonts.  Unless you assign
  481.      these  fonts correctly, the IBM graphics emulation will not work!
  482.  
  483.      Important!
  484.      ----------
  485.      Users  of  NComm V1.9 should reinstall the fonts, since they have
  486.      been redesigned by Bjørn Rybakken!  Users  of V1.8 MUST reinstall
  487.      the fonts since they had a bug.
  488.  
  489.      The  batchfile  will also copy the XPRZmodem.library to the LIBS:
  490.      directory.   This  is  a  public  domain  Zmodem library that was
  491.      created  by  Rick  Huebner  -  thanks  a  lot!  The file  MUST be
  492.      present,  or  the Zmodem protocol won't work!  The version number
  493.      included  is  2.5.
  494.  
  495.      The  XPRKermit.library  will also be copied, and is necessary for
  496.      Kermit to work. It was made by Stephen Walton. The version number
  497.      included is 1.5.  This  version  is told to contain several bugs,
  498.      and  Stephen  is  working hard on a new release which is expected
  499.      soon.  I  highly  recommend  switching to the new version when it
  500.      arrives.
  501.  
  502.      Finally,  the  batchfile  file  will  copy  the  ReqTools.library
  503.      (V38.1092/38.390) to the LIBS dir. and set up an NComm assignment
  504.      to  the  current directory.  Thanks to Nico François for creating
  505.      this great library. ReqTools is Copyright (c) Nico François.
  506.  
  507.      NOTE:   Only  the  XprZmodem  and  XprKermit  libraries have been
  508.      included.  Please specify which protocols you would like included
  509.      when registering...
  510.  
  511. 2.5  Data files
  512.      ----------
  513.      It  is  important  for  NComm  to know where it can find its data
  514.      files,  and  we must help it on its way.  If NComm was unarced in
  515.      the  ROOT  directory  of  a  floppy  disk,  relabel  the  disk as
  516.      "NComm".   This  can  be done with the following command if NComm
  517.      resides on df1:
  518.  
  519.          1> Relabel drive df1: name "NComm"
  520.  
  521.      If  the  files  were unarced within a directory or on a harddisk,
  522.      you  must  assign "NComm:" to the directory that NComm resides in
  523.      including full device and path names.
  524.  
  525.      Examples:
  526.  
  527.          1> Assign NComm: "df1:"
  528.  
  529.      ...expects NComm to reside in the ROOT directory of drive "df1:"
  530.  
  531.          1> Assign NComm: "dh0:NComm_3.0"
  532.  
  533.      ...expects NComm to reside in directory "NComm_3.0" on "dh0:"
  534.  
  535.      If  you  do  not  wish  to  name  the  disk that NComm resides on
  536.      'NComm',   it   is   probably   a   good   idea   to   edit   the
  537.      "s:startup-sequence"  file  and  add  the assign command that you
  538.      just entered.
  539.  
  540. 2.6  NComm  has  an  inbuilt  command  for opening a new Shell. If NComm
  541.      should  not  use the normal "NewShell" command for opening the Shell,
  542.      this  can  be  done  by  using  the SetEnv command in WB1.3.  For
  543.      example:
  544.  
  545.         1> setenv NEWShell "NewSHELL *"newcon:0/11/640/245/NCommShell*""
  546.  
  547. 2.7  NComm  normally  opens the serial.device in "exclusive" mode.  If
  548.      another  program is using the serial port, NComm will not be able
  549.      to  run in "exclusive" mode.  NComm will in this case try opening
  550.      the  serial  port  in  shared mode.
  551.  
  552. 2.8  NComm has the following synopsis when started from Shell:
  553.  
  554.         1> NComm [SCRIPTFILE]  [-cCONFIGFILE] [-mMACROFILE]
  555.                  [-pPHONEBOOK] [-sSCROLLBACK] [-d(ISABLE ADDING)]
  556.                  [-e(NABLE DSR/CTS ERROR MESSAGES)]
  557.                  [-rAREXXSCRIPT]
  558.  
  559.      Note: The -r option must be the last one if specified.
  560.  
  561.      From WorkBench, just click on the NComm icon.
  562.      (You may also shift-select an ARexx or NComm script from WB).
  563.  
  564. 2.9  Note:
  565.      -----
  566.      Single-drive  users  have  to  execute  these  commands  in a bit
  567.      different  manner.  Either  you can copy the needed commands into
  568.      RAM:   and  assign  c:   to  RAM:,  or  you may enter the desired
  569.      commands  with   just  a question mark as command-line.  You will
  570.      then  be  given  a  long  prompt,  at  which you should enter the
  571.      normal   command-line"  with  drive  specified  as  df0:.  As  an
  572.      example, here is how to relabel a disk...
  573.  
  574.      Boot your AmigaDOS disk in df0: and enter this at the prompt:
  575.  
  576.         1> Relabel ?
  577.  
  578.      "DRIVE/A,NAME/A"  now  appears  on the screen.   Now put your new
  579.      NComm disk in df0:  and enter this:
  580.  
  581.         drive df0: name "NComm"
  582.  
  583. 2.10 How to configure NComm for use with MBBS.
  584.      -----------------------------------------
  585.  
  586.      To   get  the  most  from  NComm when using the MBBS program, you
  587.      should   log  in at the MBBS boards you are going to use.  In the
  588.      utility   menu,  there are several options that have to be turned
  589.      on.    Walk  to  the utility menu with the (U)tility command, and
  590.      select  (M)ode  changes.   Answer  'YES'  at  all  prompts.   The
  591.      message  'User  profile  updated'  will  be  displayed.  Now,  if
  592.      you're  using  a  PAL  machine, you probably want to  configure a
  593.      larger number of lines per page than what has been  configured by
  594.      MBBS.  Select  (L)ines  per page, and enter '29' at  the  prompt.
  595.      Finally, select  IBM  graphics by using the (S)et  character  set
  596.      command. Enter 'IBN' at the prompt.
  597.  
  598.      Some   options  must  now  be  turned  on  in NComm.  Walk to the
  599.      'Transfer'  menu, and turn  on the 'G&R Protocol'.  Configure the
  600.      default  directories for these transfers if you don't have enough
  601.      memory  to  use the RAM DISK.  Now, examine that your 'Com' setup
  602.      is  8N1.   Always  use this setup when connecting to MBBS boards,
  603.      otherwise  high  bits  will be stripped.  Turn the 'IBN character
  604.      set'  on in the 'Translate' menu.  Turn the '8 Colour' mode on in
  605.      the  screen menu, and 'Reset' the colours by opening the palette.
  606.      You  now  have  true ANSI graphics!  Remember to save the present
  607.      configuration.
  608.  
  609. 2.11 A note about using NComm with Ymodem-G and High Speed modems
  610.      ------------------------------------------------------------
  611.  
  612.      Characters   may  sometimes  disappear when using NComm with baud
  613.      rates   above  9600 baud.  This is not due to a bug in NComm, but
  614.      is   caused  by  a  problem  with either the serial.device or the
  615.      Amiga   hardware.
  616.  
  617.      If   you  want  to  perform file transfer with modems like the US
  618.      Robotics  HST,  we   recommend  using  the  Zmodem error checking
  619.      protocol.   It  is  not safe to use the Ymodem-G protocol at high
  620.      baud  rates  even  if the  modem is having MNP available - errors
  621.      may occur!.
  622.  
  623.      We   apologize  for this, and hope this will be fixed in a future
  624.      version  of  the  Amiga  software  or hardware!  We have tried to
  625.      shorten   down  the  cable  between the modem and the machine but
  626.      that   didn't  seem  to  help.  We have checked every other Amiga
  627.      comms  program available, and the same thing seems to happen with
  628.      them.
  629.  
  630. 2.12 How to obtain high transfer rates with HST / V.32bis modems
  631.      -----------------------------------------------------------
  632.  
  633.      Some  people  have reported that they are not able to obtain high
  634.      transfer  rates  with  the Zmodem protocol.  I personally have no
  635.      problems  reaching  1700  CPS with NComm on a standard Amiga 2000
  636.      with many programs waiting in the background.  Please read trough
  637.      this list of possible faults before sending any more complaints.
  638.  
  639.      *  Some  versions of the serial.device miscalculate the baud rate
  640.         by 1.1% and may therefore either slow transfers down, or cause
  641.         errors. If  you  experience  such problems,  try  setting  the
  642.         adjust factor to -11 (it should normally be set to zero!)
  643.  
  644.      *  Use  the newest version of serial.device, i.e 34.104 or above.
  645.         Test your version number with the following command...
  646.  
  647.         1> version serial.device
  648.  
  649.      *  The sending  protocol and the hardware used by the BBS is also
  650.         very important, as well as noise on the telephone line. If you
  651.         have  problems  with  reaching  high baud rates, this may be a
  652.         problem with the BBS program or the telephone line.
  653.  
  654.      *  With  the standard Amiga serial.device you should NOT lock the
  655.         baud rate at anything higher than 19200 baud  (unless  you are
  656.         using  a  machine  equipped  with  a  68020  or 68030 card). A
  657.         standard  Amiga  does  only  handle transfers at a  maximum of
  658.         31250 baud...
  659.  
  660.      *  When  using  the  ASDG Dual Serial Board, you must remember to
  661.         lock  the baud  rate at 38400 baud. Otherwise the buffer might
  662.         overflow.
  663.  
  664.      *  Check  the  cabling.  The  RS232  cable  should be as short as
  665.         possible,  and  protected against electrical interference. The
  666.         same  thing  goes for the telephone cable. The cabling is very
  667.         important for obtaining high transfer rates.
  668.  
  669.      *  Your  modem  must  be set up correctly.  These US Robotics HST
  670.         settings have been tested and work very well:
  671.  
  672.         Courier HST (non-V32/V42 version)
  673.         ---------------------------------
  674.         AT &F B1 X4 &B1&C1&D2&G0&H1&I0 <cr>
  675.         AT &J0&K0&L0&M4&N8&P0&R2&S0&X1&Y1 &W <cr>
  676.  
  677.         Courier HST Dual Standard (V32/V42 version)
  678.         -------------------------------------------
  679.         AT &F B0X4 &A3&B1&H1&K3&R2&S0S28=20 &W <cr>
  680.  
  681.      *  Don't  multitask,  i.e  don't  have  anything  running  in the
  682.         background  since this will slow things down and cause errors.
  683.         Even a simple operation like bringing another screen or window
  684.         to front, may cause errors!
  685.  
  686.      *  Utility Programs like  PopCLI, QMouse, VirusX, Mach and so on,
  687.         may be quite cruel to the  system, especially if they run at a
  688.         high priority - try removing them if you experience problems.
  689.  
  690.      *  Use  TWO  colours, NO interlace, NO overscan.  Everything else
  691.         will slow transfers down and cause errors.
  692.  
  693.      *  Turn  on CTS/RTS handshaking in NComm.  To be able to use this
  694.         hardware   handshaking,   your  modem  must  also  be  set  up
  695.         correctly!   You  will  have  to use a cable with pins 4 and 5
  696.         connected.   The  CTS  and  DSR  signal  must be constantly on
  697.         before  starting  NComm.   See  your modem users manual if you
  698.         don't know how to configure it correctly. If your modem is not
  699.         responding when CTS/RTS has been turned on, it means that CTS/
  700.         RTS is working but your modem has been set up wrong.
  701.  
  702.      *  Zmodem ACKknowledge should be turned OFF. Transfers should  go
  703.         to  RAM:  or  a fast  harddisk. Otherwise, Zmodem will HAVE to
  704.         acknowledge for every 16th block received.
  705.  
  706.      *  Setting  the priority of  NComm to one or higher will normally
  707.         give  best  results.  We  recommend setting the priority to at
  708.         least  one.  Setting  the  priority  to  16  or  higher is NOT
  709.         recommended.
  710.  
  711.      *  Transfer  to  RAM:  or  a fast  harddisk. Floppy drives do not
  712.         handle  transfers  at  anything  more  than  9600  baud!  Some
  713.         harddisks  hog the CPU when reading or writing. This can cause
  714.         errors  during  transfers.  If you experience such problems, I
  715.         recommend   that   you  use  RAM:  as  your  default  download
  716.         directory,  and  transfer the files to a permanent media after
  717.         having logged off the bulletin board.
  718.  
  719. 2.13 There  has  been  some  problems  with  setting  up the TBK 9600+
  720.      auto-dialling modem for use with NComm. I recommend the following
  721.      initialization, which has been tested and works very well:
  722.  
  723.      Modem should be used with 19200 baud constant local speed.
  724.  
  725.      -----------------------------------------------------------------
  726.      AT &F                        Reset modem to factory configuration
  727.      -----------------------------------------------------------------
  728.      AT B0 &C1 &D2                 CCITT, DCD track on, DTR hang-up on
  729.      AT &S0                      (Very important!) Constant DSR signal
  730.      -----------------------------------------------------------------
  731.      AT &G0 M0 (M1)?              Guard tone off, Loudspeaker off (on)
  732.      -----------------------------------------------------------------
  733.      AT %C0 +C1 +D0              MNP5 off, Constant speed, 1300 Hz off
  734.      AT \N3 \Q3                      Auto-MNP on, RTS/CTS flow control
  735.      AT +Q3 +T1                         Extra result codes, Trellis on
  736.      -----------------------------------------------------------------
  737.      AT &W0 &W1                        Store new config in both setups
  738.      AT Z                                And reset modem to new config
  739.      -----------------------------------------------------------------
  740.  
  741.      And now, remember to turn on CTS/RTS in NComm.
  742.  
  743. 2.14 If you want to use another icon than the one supplied with NComm,
  744.      remember to set the stack size to 10000 bytes. Otherwise, you may
  745.      experience  that  NComm gives you a software failure from time to
  746.      time  -  not funny at all.  When starting NComm from Shell,  your
  747.      stack size must also be at least 10000 bytes. This is set via the
  748.      shell command: "1> STACK 10000"
  749.  
  750.  
  751. CHAPTER 3: COMMANDS IN SYSTEM MENU
  752.  
  753. 3.1  Here  you  control  all system functions.  From here you can load
  754.      and  save  settings, view the status, edit the macrokeys, turn on
  755.      and  off  the  printer, and start a new Shell.  You can also choose
  756.      whether  NComm should add entries to the logfile when you connect
  757.      with  a  board.   You  may  also exit NComm from here, as well as
  758.      execute script-files.
  759.  
  760. 3.2  About NComm
  761.         Will tell you a few things about NComm and the author.  Simply
  762.         click in the window to close it...
  763.  
  764. 3.3  Status
  765.         This  will  bring  up  a  status display showing the amount of
  766.         memory  available, the state of the printer and capture buffer
  767.         toggles.  If  the  capture  buffer  has  been  turned  on, the
  768.         filename will also be displayed.
  769.  
  770.         Here  you  will  also  find  a  slider gadget for use with the
  771.         "ASCII  send"  and  "message  send"  functions.  Some Bulletin
  772.         Board  Systems  lose  data  if is being sent too fast, so this
  773.         function can be very useful.
  774.  
  775. 3.3.1   You  can  select  a  time  to  delay  after  transmitting each
  776.         character  by  using  this  slider  gadget.  The gadget can be
  777.         adjusted from approx  20ms  (Fast)  to  300  ms  (Slow)  delay
  778.         between  transmitted  characters.   The slider can be adjusted
  779.         while a file is being sent to allow for fine tuning.
  780.  
  781.         With  the  slider in the (default) far left position, there is
  782.         no delay.
  783.  
  784. 3.3.2   A  scrollback buffer can be set with the second slider gadget.
  785.         This  can  be useful if you often loose CARRIER while entering
  786.         messages  or if you are bothered by pages often scrolling past
  787.         your screen.  Here you can set the buffer size, i.e.  how much
  788.         NComm  at  all  times shall remember of the incoming data.  If
  789.         you are using a 512K Amiga, it may be wise to use only a small
  790.         scrollback  buffer.   Set the scrollback buffer to '0K' if you
  791.         want to turn off this option, or want to clear the buffer.
  792.  
  793. 3.4 Load config
  794.         Will load a new NComm configuration.  All menu options and the
  795.         status  window  settings  are  covered  by this function.  The
  796.         macrokeys and the phonebook must be loaded separately.  A file
  797.         input requester will appear in the center of the screen.  Only
  798.         files with a ".config" suffix will be shown.
  799.  
  800. 3.5 Save config
  801.         Will  save  the current NComm configuration.  All menu options
  802.         and  the  status window settings are covered by this function.
  803.         The  macrokeys  and the phonebook must be saved separately.  A
  804.         file  input requester will appear in the center of the screen.
  805.  
  806.         Please  note  that  this  option  also snapshots the terminal,
  807.         split  screen  and scrollback windows.  When restarting NComm,
  808.         all windows will have their original position and size.
  809.  
  810. 3.6 Script
  811.         This  function  will  execute  a  scriptfile.   A  file  input
  812.         requester will appear in the center of the screen.  Select the
  813.         script  you  want  to run.  The text SCR will be displayed on
  814.         the  status  line.  To stop a script, select this entry again.
  815.         See the file "Script.doc" for detailed information on scripts.
  816.  
  817. 3.7 Macrokeys
  818.         This  will  bring  up  a  requester  that  lets  you  edit the
  819.         macrokeys.   Here  you  may  also load new macros and save the
  820.         text  stored  on  the  different macrokeys.  The function keys
  821.         definable  are  F1  to  F10 and SHIFT F1 to F10.  You may also
  822.         define what the cursor keys should send when shifted.  A macro
  823.         definiton  can  be 512 bytes maximum.  Not all keys have to be
  824.         defined.   To  edit a macro just click in one of the requester
  825.         text  input  boxes  and enter your definition.  The macros can
  826.         contain  control  characters  which  can be represented in two
  827.         ways.   These  characters  can also be used in the modem setup
  828.         requester or in scripts when using the SEND commands.
  829.  
  830. 3.7.1           1.    C-style   slash   conventions.    The  following
  831.                       sequences are supported:
  832.  
  833.                     \n, \r      Carriage Return
  834.                     \t          Tabulator
  835.                     \f          Form Feed
  836.                     \b          BackSpace
  837.                     \v          Vertical Tabulator
  838.                     \e          Escape
  839.                     \\          Backslash
  840.                     \"          Quote
  841.                     \u          PhoneBook Username
  842.                     \p          Phonebook Password
  843.                     \w          .5 second Delay
  844.                     \l          250 ms Line Break
  845.                     \m          Macro
  846.                     \i          Send modem init string
  847.                     \xHEXNUMBER Send ASCII hex-character f.ex. \x1b
  848.                     \NUMBER     Send ASCII character f.ex \32 (space)
  849.  
  850.                 2.    The   caret   followed   by  a  letter,  meaning
  851.                       CTRL+letter.    If   you   need  the  line  feed
  852.                       character, for example, use  ^J.  '^^' will send
  853.                       the caret itself.
  854.  
  855.         A scriptfile may be started  from a macro by entering {script}
  856.         followed  by  the  name and path of the scriptfile you want to
  857.         execute. Example: {script}RAM:test.script
  858.  
  859.         An  arexx  scriptfile  may be started from a macro by entering
  860.         {arexx} followed by the name, path and optional parameters for
  861.         the arexx scriptfile.  Example:  {arexx}ncomm:testrx.ncomm
  862.  
  863.         You  can have nested macros by using the \m## option, where ##
  864.         is a number from 1 to 20 - with 1 representing macro F1 and 11
  865.         and 20 representing Shift F1 and Shift F20 respectively.
  866.  
  867.         Examples:
  868.  
  869.         commodore            ;Will not add a carriage return.
  870.         at \\N3\n            ;AT \N3 plus a carriage return.
  871.         ^pread               ;The control-P code, followed by 'read'.
  872.         \m1\m2run testfile\r ;The text stored on macro F1 and F2, plus
  873.                              ;the text 'run testfile' and a CR.
  874.  
  875. 3.7.2   Selecting  the 'Load' gadget will bring up a file requester in
  876.         the  center  of  the  screen.   From  here  you  may  load new
  877.         macrokeys.   Remember  to  save  the  current macrokeys if any
  878.         changes  have  been made.  Entering "NComm.keys" will load the
  879.         macrokeys that are normally loaded at startup.
  880.  
  881. 3.7.3   Selecting  the 'Save' gadget will bring up a file requester in
  882.         the  center of the screen.  From here you may save the current
  883.         macrokeys.   Enter  the  name  "NComm.keys"  if  you  want the
  884.         macrokeys to be loaded on startup.
  885.  
  886. 3.7.4   Selecting  the 'Cancel' gadget will leave everything unchanged
  887.         and remove the macrokeys window.
  888.  
  889. 3.7.5   Selecting  the  'OK'  gadget will close the window and install
  890.         the new macros.
  891.  
  892. 3.8 Printer
  893.         Toggles  the  printer ON/OFF.  When ON, text received from the
  894.         serial  port  will  also  go to the device you specify  in the
  895.         requester  (PRT:  is  recommended).  The  text  'PRT'  will be
  896.         displayed on the status line.
  897.  
  898. 3.9 New Shell
  899.         Works  like the "NewShell" command, which must be present in the
  900.         C:  directory together with the 'RUN' command.  Will open up a
  901.         command line interface on the Workbench screen.  Type 'EndShell'
  902.         to exit the Shell and return to NComm.
  903.  
  904. 3.10 Log Calls
  905.         When  this  option is turned on, NComm will log all calls made
  906.         within  NComm.  The  information  will  be added to a textfile
  907.         called  "NComm.log".
  908.  
  909. 3.11 Log Phone Info
  910.         When   this   option   is   turned   on,  the  phonebook  will
  911.         automatically be saved at CONNECT so that we can keep track on
  912.         when  the boards were last dialled and how many times you have
  913.         been online...
  914.  
  915. 3.12 Set Priority
  916.         This  option  allows  you  to  increase  or decrease the NComm
  917.         priority a bit. Bumping the priority is especially recommended
  918.         when using high speed modems. This will decrease the number of
  919.         errors and also increases the transfer rate.
  920.  
  921. 3.13 ARexx Script
  922.         This  function will execute an arexx scriptfile.  A file input
  923.         requester will appear in the center of the screen.  Select the
  924.         arexx  script  that you want to run.  See the file "ARexx.doc"
  925.         for  detailed  information  on  arexx  scripts  and  available
  926.         commands.
  927.  
  928. 3.14 Quit NComm
  929.         Selecting this entry will close all open files and windows and
  930.         exit back to the operating system.
  931.  
  932.         NOTE:  If you want to disable the Quit requester, you may turn
  933.         it  off by setting an environment variable.  Add the following
  934.         line to your "S:User-Startup" file:
  935.  
  936.         SETENV NCOMM_NOQUITREQ "TRUE"
  937.  
  938. CHAPTER 4: COMMANDS IN FILE MENU
  939.  
  940. 4.1  This  is  the  file  transfer  menu.   From  here you can start a
  941.      transfer  and select the different transfer options i.e protocol,
  942.      handshaking etc.
  943.  
  944.      When  the  upload  or download function is selected, a file input
  945.      requester  will  appear, that is if you have not selected the G&R
  946.      mode. click on the "Ok" gadget when you have selected a file.
  947.  
  948. 4.2 Start ASCII Capture
  949.         All  data received from the serial port is also saved into the
  950.         named  file.   The text is buffered and written to the disk in
  951.         8K blocks.  If you are using a translation table, the incoming
  952.         data  will  be  translated.  Select the 'ISO' character set to
  953.         avoid this.
  954.  
  955.         When  this  mode  is  selected,  the text in the MENU entry is
  956.         changed  to  "Stop  ASCII Capture".  Selecting this entry will
  957.         flush the data buffer to the disk and close the file.
  958.  
  959.         When  capturing  is enabled, the word "CAP" will be visible on
  960.         the status line.
  961.  
  962.         When entering a filename for data capture, NComm will check to
  963.         see if this file already exists.  If it does, a requester will
  964.         appear  informing  you  of  that fact.  You may then choose to
  965.         CONTINUE  using  the  filename  entered  or  CANCEL  and enter
  966.         another  filename.   If  you  choose  to CONTINUE, you will be
  967.         presented  with another requester.  You can APPEND data to the
  968.         existing  file  or  DELETE  the existing data and start with a
  969.         fresh file.
  970.  
  971. 4.3 Start ASCII Send
  972.         The  named  file will be read and sent to the serial port.  If
  973.         the  file  does  not  exist,  a message to that effect will be
  974.         printed.   If  you are using a translation table, the outgoing
  975.         data  will  be  translated.   Select  the 'ISO' translation to
  976.         avoid this.
  977.  
  978.         When  this  mode  is  selected,  the text in the MENU entry is
  979.         changed  to "Stop ASCII Send".  Selecting this entry will stop
  980.         the transfer and close the disk file.
  981.  
  982. 4.4 Message upload
  983.         The  named  file will be read and sent to the serial port.  If
  984.         the  file  does  not exist, a warning message will be printed.
  985.         If  you  are using a translation table, the outgoing data will
  986.         be translated.  Select the 'ISO' translation to avoid this.
  987.  
  988.         This function will perform almost like "Start ASCII send", but
  989.         the  message  will  be packed.  Blank lines will be translated
  990.         into  spaces.   This  can  be useful when uploading to systems
  991.         with  a  certain  pagewidth, or if your message contains blank
  992.         lines  (usually  you  will  exit  the editor when a blank line
  993.         occurs in a message you upload with the ASCII send function.)
  994.  
  995.         Select  this  entry  again  to stop the transfer and close the
  996.         disk file.
  997.  
  998. 4.5 Download
  999.         The  named  file  will be created on the disk and the transfer
  1000.         will  be  started  using the protocol you have selected in the
  1001.         TRANSFER menu.
  1002.  
  1003.         If the specified file already exists, a requester will appear;
  1004.         asking  if  you  want  to  CONTINUE  or CANCEL the use of that
  1005.         filename.   Selecting CONTINUE will overwrite the old existing
  1006.         file  with  the  new  one.  Selecting CANCEL will bring up the
  1007.         INPUT WINDOW allowing you to enter another file name.
  1008.  
  1009.         A  window will pop up that among other things will display the
  1010.         name  of  the  file  being transferred, a running total of the
  1011.         bytes  received,  the  number of NAKs and the last block to be
  1012.         NAKed.  The transfer can be aborted by hitting the ESC key, or
  1013.         by pressing the upper left-hand close gadget. The current file
  1014.         can be skipped by pressing the gadget marked "Skip File".
  1015.  
  1016.         The  serial  port  parameters  will  be saved and changed to 8
  1017.         bits,   no   parity,  1  stop  bit  for  the  transfer.   Upon
  1018.         completion, the old settings will be restored.
  1019.  
  1020. 4.6 Upload
  1021.         Use  this selection to transmit a file to a system.  The named
  1022.         file  will  be  opened  on  the  disk and the transfer will be
  1023.         started  using  the  error  checking  method (CRC or Checksum)
  1024.         selected by the receiving end.
  1025.  
  1026.         Ymodem-Batch/G  and  Zmodem support batch uploading. Hold down
  1027.         the  SHIFT key  if  you  want  to select multiple files in the
  1028.         file requester.
  1029.  
  1030.         If  the specified file does not exist, a requester will appear
  1031.         informing  you  of  this  fact.   You  only have the option to
  1032.         CONTINUE, which will bring up the INPUT WINDOW allowing you to
  1033.         re-enter the filename or CANCEL the upload.
  1034.  
  1035.         A  window will pop up that among other things will display the
  1036.         name  of  the  file  being transferred, a running total of the
  1037.         bytes  sent,  the  number of NAKs and the  last  block  to  be
  1038.         NAKed.  The transfer can be aborted by hitting the ESC key, or
  1039.         by pressing the upper left-hand close gadget. The current file
  1040.         can be skipped by pressing the gadget marked "Skip File".
  1041.  
  1042.         As   described  in  the  Download  section,  the  serial  port
  1043.         parameters  are  temporarily  changed to 8N1 for the transfer.
  1044.  
  1045. 4.7 Options
  1046.  
  1047. 4.7.1           CRC
  1048.         This  function  selects the type of error checking to be used
  1049.         during  Xmodem  transfers.  If  CRC  is  not  turned  on, the
  1050.         checksum method will be used.
  1051.  
  1052.         The  original  Christensen protocol used an 8 bit checksum for
  1053.         error checking.  It is about 97% effective in catching errors.
  1054.         All  implementations  of  XMODEM  can use the checksum method.
  1055.         Only  use  the cheksum method when in doubt, the CRC method is
  1056.         much more secure.
  1057.  
  1058.         A  later  addition  to  the protocol was the 16 bit (two byte)
  1059.         Cyclic  Redundancy  Check  (  CRC  )  which  is  about 99.997%
  1060.         effective  in  detecting  errors.   Not all implementations of
  1061.         XMODEM  can  use  the CRC method.
  1062.  
  1063. 4.7.2           Chop Files
  1064.         File  transfers  will  increase the size of a file to the next
  1065.         largest  multiple  of  128 bytes for XModem transfers and 1024
  1066.         bytes  for  YModem.   The  CHOP  FILES  option will remove the
  1067.         padding  on the end of the file.  This is always required when
  1068.         transferring   executable  binary  files.   CHOPing  files  is
  1069.         therefore desired.
  1070.  
  1071.         Note:
  1072.         It is not desireable to CHOP an .ARC, .ZOO, .PAK or .ZIP file.
  1073.         As  it  is  very  easy to forget to turn off the CHOP mode for
  1074.         these files, NComm will check the receive-filename for such an
  1075.         extension.   If  this  is  found,  it will temporarily disable
  1076.         CHOPing  for  this file and on completion of transfer the CHOP
  1077.         flag will be reset to its previous value.
  1078.  
  1079. 4.7.3           G & R Protocol
  1080.         This  is  an  auto  up/download protocol for use with the MBBS
  1081.         system.   You  must  remember to also turn on G&R in your MBBS
  1082.         user  account to make it work.  By using this protocol, you no
  1083.         longer  have  to  enter  the  desired protocol and filename in
  1084.         NComm  when  transferring  files  to  and from an MBBS system.
  1085.         This  means that you do not have to deal with the tedious file
  1086.         requester.
  1087.  
  1088. 4.7.4           G & R Host Mode
  1089.         This  feature  is meant to be used when two NComm programs (or
  1090.         one  NComm and one GLink program) are connected to each other.
  1091.         You  may  use a nullmodem cable or two modems. When one of the
  1092.         programs  have  been  set  to  utilize  this feature, the file
  1093.         transfer  can be controlled from that machine. All you have to
  1094.         specify is protocol, filename and up/download.
  1095.  
  1096. 4.7.5           Zmodem RESUME
  1097.         If  this  feature  has  been turned on, NComm will not discard
  1098.         existing  data  when  using  Zmodem  download.   Data  will be
  1099.         appended  to  the  file  until  the  filesize  is correct.  No
  1100.         requester  will  appear.   Turn  this  feature  on  if you for
  1101.         example loose carrier during a Zmodem download - you will then
  1102.         only have to transfer the bytes that are missing.
  1103.  
  1104. 4.7.6           Zmodem AUTODL
  1105.         If  this  feature has been turned on, NComm will automatically
  1106.         jump into receive mode when the string '**^XB00' is  received.
  1107.         This  means  that  you  won't have to select Download from the
  1108.         menu when transferring with Zmodem.
  1109.  
  1110. 4.7.7           Zmodem AUTOUL
  1111.         If  this  feature has been turned on, NComm will pop up with a
  1112.         file  requester  when  the string '**^XB01' is  received. This
  1113.         means  that you won't have to select Upload from the menu when
  1114.         transferring with Zmodem.
  1115.  
  1116. 4.7.8           Zmodem ACK
  1117.         This  option  turns  on  Zmodem  ACK, and will force Zmodem to
  1118.         acknowledge  each  16th  block  received.  This will of course
  1119.         slow   transfers  down  so  only  turn  ACK   on  if  you  are
  1120.         transferring  to  a very slow device (errors may then occur if
  1121.         this feature has NOT been turned on). NComm will automatically
  1122.         turn Zmodem ACK on when transferring to DFx: at speeds greater
  1123.         than 9600 baud.
  1124.  
  1125. 4.7.9           Zmodem BufSize
  1126.         This  option  sets  the size of XPRZmodem's file I/O buffer in
  1127.         kilobytes.  The minimum size is 1KB, the maximum value is 1024
  1128.         KB  (1MB). I recommend entering a value of 16.
  1129.  
  1130. 4.7.10          Kermit host
  1131.         If this option is turned on, the host  Kermit is assumed to be
  1132.         in server mode. You will be prompted  for file names  when you
  1133.         request a Kermit receive, and  this  file  name  will  be sent
  1134.         to the server in form of a Kermit GET command.
  1135.  
  1136. 4.7.11          Kermit 1k blocks
  1137.         Will set the Kermit packet length to 1024 bytes and set 16-bit
  1138.         CRC block checking.  This should increase the transfer speed a
  1139.         bit.   A  packet  length of 94 will be used if this feature is
  1140.         turned  off.   Not  all  Kermit  implementations  support long
  1141.         packets.
  1142.  
  1143. 4.7.12          External XPR setup
  1144.         Select  this function if you want to change the parameters for
  1145.         the  External XPR library.  Answers yes if you want to enter a
  1146.         init  string  with options that should be used by the External
  1147.         XPR   library.    Please   refer   to   the  external  library
  1148.         documentation  for a list of valid commands or parameters.  If
  1149.         you answer no, this function asks the External XPR library for
  1150.         a  "query".   The  library  will  then  display  the different
  1151.         options  that  can  be  set and their default values.  You may
  1152.         of course change the options as you like.
  1153.  
  1154. 4.7.13          Create icons
  1155.         Turn  this  option  on if you want NComm to create an icon for
  1156.         all files that you download.
  1157.  
  1158. 4.7.14          File comments
  1159.        If  this option has been selected, NComm will add a filenote to
  1160.        the  file after a download. The filenote consists of either the
  1161.        boardname  or  the telephone-number to the board where the file
  1162.        was  collected  from. The filenote may for example be displayed
  1163.        with the Shell "list" command.  The CPS rate will also be added
  1164.        to the FileNote.
  1165.  
  1166. 4.7.15          Transfer bar
  1167.         Turn  this  option  on  if  NComm  should  display a download/
  1168.         upload bar when transferring files.
  1169.  
  1170. 4.8 Server Commands
  1171.         These  commands  are  only  valid when the Kermit protocol has
  1172.         been selected. XPRKermit.library must be present in LIBS:
  1173.  
  1174. 4.8.1           Kermit Finish
  1175.         Tells  a  Kermit  server  that you are done. The remote server
  1176.         will stop being a server.
  1177.  
  1178. 4.8.2           Kermit Bye
  1179.         Tells  a Kermit server that you are done; the server will exit
  1180.         and log you off the remote machine.
  1181.  
  1182. 4.8.3           Kermit CD
  1183.         Changes  the  default  directory for files sent or received by
  1184.         the  Kermit  server.  Examples  of the directory name would be
  1185.         '/bin' or 'user:[username.amiga]'.
  1186.  
  1187. 4.9 Protocol
  1188.         Here  you select the protocol you want used for the upload and
  1189.         download functions.
  1190.  
  1191. 4.9.1           XMODEM
  1192.         This  is  the protocol originally written by Ward Christensen.
  1193.         It is used by almost every type of personal computer.  This is
  1194.         a  good  protocol  to  use  if  the line quality is poor.  Its
  1195.         biggest  drawback is that it transfers data in 128 byte blocks
  1196.         making it slower than YMODEM.
  1197.  
  1198. 4.9.2           YMODEM
  1199.         This  is  basically  XModem-CRC  with  1024 byte blocks.  This
  1200.         means  that  there  is less  handshaking,  which  saves  time.
  1201.         YMODEM is faster than  XMODEM  as  long as the line quality is
  1202.         acceptable.
  1203.  
  1204. 4.9.3           YMODEM-BATCH
  1205.         This  is  a  more  intelligent version of the YMODEM protocol.
  1206.         Multiple  files  may  be  sent  as  a packet, and the protocol
  1207.         automatically sends information about filename and filesize.
  1208.  
  1209. 4.9.4           YMODEM-G
  1210.         This is basically YMODEM-BATCH without error checking.  It may
  1211.         only   be   used   when   two   error  correcting  modems  are
  1212.         communicating  with  each  other.   Configure this with boards
  1213.         supporting MNP or ARQ. Please see above for a note about using
  1214.         this protocol with high speed modems.
  1215.  
  1216. 4.9.5           ZMODEM
  1217.         This  is  currently  one of the fastest file transfer protocol
  1218.         available.  With the Zmodem protocol, you may reach a transfer
  1219.         rate  around  1700  CPS  with  the  HST.   It  depends  on the
  1220.         XPRZmodem.library,  which  should  be  situated  in  the LIBS:
  1221.         directory.   A  file is normally sent in 1024 byte blocks, but
  1222.         this  changes  depending  on  the  system performance and line
  1223.         quality.   The  reason for its outstanding performance is that
  1224.         it  uses continuous data-streaming, and doesn't wait for an OK
  1225.         from the remote system before sending the next block.  This is
  1226.         not only a fast method to transfer data, but is also necessary
  1227.         on packet networks.
  1228.  
  1229. 4.9.6           KERMIT
  1230.         This  is  a  protocol that is widely used on many old machines
  1231.         and  network  systems.   It  depends on the XPRKermit.library,
  1232.         which  should be situated in the LIBS:  directory.  Due to the
  1233.         small  blocks  sent/received,  kermit is a quite slow protocol
  1234.         but  is  *very*  reliable and works with just about any system
  1235.         configuration,  independent  of handshaking and number of data
  1236.         bits.   Some  implementations of Kermit support compression of
  1237.         the transferred data.
  1238.  
  1239. 4.9.7           BIMODEM
  1240.        This  command  selects the external BiModem library.
  1241.        The library "xprbimodem.library" must exist in your libs: dir.
  1242.  
  1243. 4.9.8           BMODEM PLUS
  1244.        This  command  selects the external BModem Plus library.
  1245.        The library "xprbplus.library" must exist in your libs: dir.
  1246.  
  1247. 4.9.9           COMPUSERVE-B
  1248.        This  command  selects the external Compuserve Quick-B library.
  1249.        The library "xprquickb.library" must exist in your libs: dir.
  1250.  
  1251. 4.9.10          JMODEM
  1252.        This  command  selects the external Jmodem library. The library
  1253.        "xprjmodem.library" must exist in your libs: directory.
  1254.  
  1255. 4.9.11          VMS
  1256.        This  command  selects the external VMS library. The library
  1257.        "xprvms.library" must exist in your libs: directory.
  1258.  
  1259. 4.9.12          UUE-ASCII
  1260.        This  command  selects the external UUE-ASCII library. The latest
  1261.        version of "xprascii.library" must exist in your libs: directory.
  1262.        This  library  automatically  uuencodes  files that are sent and
  1263.        uudecodes files that are received.
  1264.  
  1265. 4.9.13          EXTERNAL XPR
  1266.         Use  this  function for selecting an external XPR protocol.  A
  1267.         file  requester  will  list  the libraries that are available.
  1268.         Simply double-click on the library name to select it.
  1269.  
  1270.  
  1271. 4.10 Default directory
  1272.         Here  you  may  specify  the default paths and directories for
  1273.         uploading  and  downloading,  or  change  the path for the log
  1274.         file.   A  file  requester  will  appear,  select  a  path and
  1275.         directory  and  click  on the OK gadget when you are satisfied
  1276.         with your selection.  NComm will default to these directories,
  1277.         but  as  long as you are not using the G & R protocol, you may
  1278.         change  the  path  and  directory yourself before an upload or
  1279.         download.
  1280.  
  1281.         It  may be wise to set these directories to RAM: for fast file
  1282.         transfers, since transferring to disk causes a delay.
  1283.  
  1284.         NOTE: The  "Trap List" option tells the traplist.library where
  1285.         your FIDO traplist is situated  (the trap list is a version of
  1286.         the  standard nodelist that has been processed by the traplist
  1287.         program). It will default to "NODELIST:".
  1288.  
  1289. 4.11 Load scrollback buffer
  1290.         Use  this  function  if you want to load a text file into the
  1291.         scrollback buffer.  A file requester will appear on screen.
  1292.  
  1293. 4.12 Save scrollback buffer
  1294.         Use  this  function  if you want to save what is stored in the
  1295.         scrollback buffer.  A file requester will appear on screen.
  1296.  
  1297.         Note:   If  you want to print the scrollback buffer, leave the
  1298.         directory field blank and enter "PRT:" in the filename gadget.
  1299.  
  1300. 4.13 View scrollback buffer
  1301.  
  1302.         This   function   will   bring  up  a  window  containing  two
  1303.         proportional  gadgets  and two line-by-line gadgets.  By using
  1304.         these  gadgets,  you may view what is stored in the scrollback
  1305.         buffer  and perhaps see if it is worth saving.  The scrollback
  1306.         bytesize  will  be  displayed in the window header, as well as
  1307.         the  current  buffer position and number of lines.  The cursor
  1308.         keys may also be used for moving around;
  1309.  
  1310.                   Up - One line up
  1311.                 Down - One line down
  1312.                 Left - Move half a page to the left
  1313.                Right - Move half a page to the right
  1314.  
  1315.             Shift-Up - Step one page up
  1316.           Shift-Down - Step one page down
  1317.           Shift-Left - Beginning of buffer
  1318.          Shift-Right - End of buffer
  1319.  
  1320.         Text  may  be  marked by first clicking on the first character
  1321.         that you want to mark and then clicking on the last character.
  1322.         click twice at the same character to remove all marks.
  1323.  
  1324.         Some hotkeys are supported;
  1325.  
  1326.                 "F" - Search in buffer
  1327.                 "N" - Next occurence of string
  1328.                 "L" - Load scrollback
  1329.                 "S" - Save scrollback
  1330.                 "B" - Save block
  1331.                 "Z" - Zoom/expand window
  1332.  
  1333.           Space bar - Paste block to serial port
  1334.  
  1335.         Press the CloseGadget or ESCape to close  the  window.  Please
  1336.         note  that  the scrollback will slow down when using a 8 or 16
  1337.         colour screen.
  1338.  
  1339. 4.14 Search in buffer
  1340.         This  function  search  for a string in the scrollback buffer,
  1341.         and  marks  the  line  if  found. Enter the string you want to
  1342.         search for in the string requester that pops up.
  1343.  
  1344. 4.15 Save marked block
  1345.         Select  this  function  if  you want to save the contents of a
  1346.         marked  block  onto  a  file.  A file requester will appear on
  1347.         screen, asking you for path and filename.
  1348.  
  1349.         Note:   If  you  want to print the scrollback block, leave the
  1350.         directory field blank and enter "PRT:" in the filename gadget.
  1351.  
  1352. 4.16 Send marked block
  1353.         Select  this  function  if  you want to send the contents of a
  1354.         marked block in the scrollback to the serial port.
  1355.  
  1356. 4.17 Disable adding
  1357.         By  turning this option on, you temporarily disable the adding
  1358.         of  characters  to the scrollback. Turn the adding on again by
  1359.         selecting this function once again.
  1360.  
  1361. 4.18 Clear Scrollback
  1362.         This  command  will  clear  the scrollback buffer. Use it with
  1363.         great care as it will not ask for confirmation.
  1364.  
  1365. CHAPTER 5: COMMANDS IN SERIAL MENU
  1366.  
  1367. 5.1  Serial  device  parameters  are changed here. The serial settings
  1368.      are completely independent of the settings in preferences.
  1369.  
  1370. 5.2 Baud
  1371.         Baud  rates  from  300  to 115200  baud can be selected.  This
  1372.         entry,  however, may be overridden by the default baud rate in
  1373.         the phonebook.
  1374.  
  1375.         IMPORTANT !!!  Do  NOT  use baud rates above 31500 baud with a
  1376.         standard Amiga (68000/10 processor). The processor is too slow
  1377.         for  handling  these  speeds,  and  the  serial  hardware will
  1378.         therefore  discard  most  of  the  characters received via the
  1379.         serial  port.  Some  68020  cards  also  have  problems   when
  1380.         operating at high speeds.
  1381.  
  1382.         Note:
  1383.         -----
  1384.         This  selects  the  serial  speed of the port, the actual data
  1385.         throughput  rate  depends  upon  whether the capture buffer is
  1386.         active,  if  printer  capture  is selected, if a scrollback is
  1387.         used  and  upon the screen I/O speed.
  1388.  
  1389.         With  no printer or file capture,  the throughput rate depends
  1390.         on  the  screen I/O speed. If you select a baud  rate  greater
  1391.         than  2400  baud,  you  may lose characters unless handshaking
  1392.         is being used.
  1393.  
  1394.         If you own a 68030 machine and use the program CpuBlit by Eddy
  1395.         Carroll,  the  screen  I/O  will  stick  with much higher baud
  1396.         rates.   CpuBlit also removes the flashing seen when scrolling
  1397.         colored text. Note: If you are using OS 3.0 or above, there is
  1398.         no   need   to  use  CpuBlit.  NComm  will  automatically  use
  1399.         interleaved bitmaps whereever possible.
  1400.  
  1401.         Also  note:  the  1200/75  baud option will only work with the
  1402.         internal serial port since it jumps directly on the hardware.
  1403.  
  1404. 5.3 Data Length
  1405.         Selects  the  length  of  a  data  word  as 7 or 8 bits.  Most
  1406.         computer systems today will operate with 8 bits.
  1407.  
  1408.         Note  that during binary transfers, serial port data length is
  1409.         set   to  8  bits  and  restored  to  the  previous  value  on
  1410.         completion.
  1411.  
  1412. 5.4 Parity
  1413.         Selects  NO, ODD,  EVEN, MARK or SPACE parity. Most computer
  1414.         systems today will operate with NO parity.
  1415.  
  1416.         Note  that  during binary transfers, serial port parity is set
  1417.         to NO parity and restored to the previous value on completion.
  1418.  
  1419. 5.5 Stop Bits
  1420.         Selects  the  number  of stop bits transmitted as 1 or 2 bits.
  1421.         Most computer systems today will operate with 1 stop bit.
  1422.  
  1423.         Note that during binary transfers, serial port stop bit length
  1424.         is  set  to  1  bit  and  restored  to  the  previous value on
  1425.         completion.
  1426.  
  1427.         The  Amiga hardware does not allow 2 stop bits to be used with
  1428.         an 8 bit data word length.
  1429.  
  1430. 5.6 Duplex
  1431.         Selects  whether  NComm  or  the remote system should echo key
  1432.         strokes to the screen.
  1433.  
  1434. 5.6.1   Select  FULL duplex when the remote machine will echo your key
  1435.         strokes.  You will normally be using this option.
  1436.  
  1437. 5.6.2   Select  HALF  duplex when the remote system does not echo your
  1438.         key  strokes.   That  is  when  the  remote system seems to be
  1439.         responding  to  your commands, but you cannot see what you are
  1440.         typing.
  1441.  
  1442. 5.7 Handshaking
  1443.         Enables  or  disables the serial driver check for flow control
  1444.         characters.
  1445.  
  1446. 5.7.1   Select 'None' when you do not wish to use flow control.
  1447.  
  1448. 5.7.2   Select 'XON/XOFF' when you wish the driver to use the XON/XOFF
  1449.         type  of  flow  control.   Normally this is used at baud rates
  1450.         greater than 2400 baud to avoid losing characters.
  1451.  
  1452. 5.7.3   Select  'RTS/CTS' when you wish the driver to use the hardware
  1453.         RTS/CTS  type  of flow control.  This should only be used with
  1454.         modems which support it.
  1455.  
  1456.         Note:
  1457.         In  some  cases, when the XON/XOFF mode is selected, NComm may
  1458.         receive an XOFF character ( noise or otherwise ) and appear to
  1459.         be hung -- that is, no characters appear on the screen yet the
  1460.         menus  still  function properly.  Whenever NComm appears to be
  1461.         hung,  typing  a Ctrl-Q will re-start the serial line.  If the
  1462.         problem  was  due  to  an  XOFF  character received, this will
  1463.         restore everything to normal.
  1464.  
  1465. 5.8 Set Device
  1466.         If  you are using something else than the inbuilt serial port,
  1467.         this  function  makes it possible to change the type of serial
  1468.         device  used  for  this  port. A string requester will pop up,
  1469.         asking you for the name of the new device.
  1470.  
  1471. 5.9 Set Unit
  1472.         If  you are using something else than the inbuilt serial port,
  1473.         this  function  makes it possible to change the number of the
  1474.         unit   used  for  this  port.  A number requester will pop up,
  1475.         asking you for the number of the new unit.
  1476.  
  1477. 5.10 Set Adjust Factor
  1478.         Some  versions of the serial.device miscalculate the baud rate
  1479.         by 1.1% and may therefore either slow transfers down, or cause
  1480.         errors. If  you  experience  such problems,  try  setting  the
  1481.         adjust factor to -11 (it should normally be set to zero)
  1482.  
  1483. 5.11 Shared Mode
  1484.         If another program is using the serial port, NComm will not be
  1485.         able  to  open  the  serial.device.  Setting the "Shared mode"
  1486.         option   allows  NComm  to  share the serial port with another
  1487.         program.  The disadvantage is that CTS/RTS handshaking can not
  1488.         be used when sharing the serial port.
  1489.  
  1490. 5.12 Send Break
  1491.         Sends a 250 ms break signal.
  1492.  
  1493. 5.13 Serial Open
  1494.         This  function  selects  if  the serial port should be open or
  1495.         closed.   You  may  want  to use this option if other programs
  1496.         need  to  use  the  serial port while NComm is active.  If the
  1497.         serial  port  did  not  open at startup, you may also use this
  1498.         function for reopening the serial port.
  1499.  
  1500. 5.14 Set 75bps delay
  1501.         This function sets the delay between bits that are sent to the
  1502.         serial  port when using the 1200/75 baud (split speed) option.
  1503.         12100  uS  is known to work well with an A3000/25 and AmigaDOS
  1504.         2.0,  while  10700  uS  is  probably the preferred value for a
  1505.         stock Amiga 500/1000/2000.
  1506.  
  1507. CHAPTER 6: COMMANDS IN TRANSLATE MENU
  1508.  
  1509. 6.1  This is where you define the translation of out- and ingoing data
  1510.      and the special keyboard keys.
  1511.  
  1512. 6.2  End of Line
  1513.         You  can  select how End of Line characters are handled on the
  1514.         screen  and when sent out the serial port.  By default, EOL is
  1515.         just  a  CARRIAGE RETURN character, but you can change this to
  1516.         CR  and  LINEFEED pairs.  Use this option if all text seems to
  1517.         be printed on one line.
  1518.  
  1519. 6.3  Character set
  1520.         NComm offers twelve different translation tables, and they can
  1521.         be  selected  here.  Please  observe  that you have to use the
  1522.         'Shell'  SETMAP  command  to  be  able  to  write  your national
  1523.         characters correctly.
  1524.  
  1525. 6.3.1           ISO
  1526.         NComm  will  use the standard Amiga character set, without any
  1527.         translation.  This  should  be  used when using Amiga systems,
  1528.         and will only work in 8N1.
  1529.  
  1530.         Please  note;  if no translation of the in or outgoing data is
  1531.         wanted  when  using  the  ASCII  capture or ASCII send option,
  1532.         switch to ISO before transfer.
  1533.  
  1534. 6.3.2           IBM
  1535.         Should  be  used  with  bulletin  boards  running on PC/MS-DOS
  1536.         machines  that use the IBM extended character set.  NComm will
  1537.         utilize  a  special  IBM  font  containg  all  the IBM graphic
  1538.         characters. This will only work in 8N1.
  1539.  
  1540. 6.3.3           IBN
  1541.         Should  be  used  with  Norwegian  bulletin  boards running on
  1542.         PC/MS-DOS  machines  that  use the IBM extended character set.
  1543.         This  is  a  version  of  the  character set that contains two
  1544.         norwegian   characters  that  are  missing  in  IBMs  original
  1545.         character   set.   NComm  will  utilize  a  special  IBM  font
  1546.         containing  all  the  IBM  graphic characters.  This will only
  1547.         work in 8N1.
  1548.  
  1549. 6.3.4           IBP
  1550.         Should  be  used  with  Portuguese bulletin  boards running on
  1551.         PC/MS-DOS  machines  that  use the IBM extended character set.
  1552.         This  is  a  version  of  the character set that contains some
  1553.         special   Portuguese  characters  that  are  missing  in  IBMs
  1554.         original character set.  NComm will utilize a special IBM font
  1555.         containing  all  the  IBM  graphic characters.  This will only
  1556.         work in 8N1.
  1557.  
  1558. 6.3.5           NO7
  1559.         Use this option when the host uses
  1560.         the Norwegian ISO 7 bit standard.
  1561.  
  1562. 6.3.6           US7
  1563.         Use this option when the host uses
  1564.         the American ISO 7 bit standard.
  1565.  
  1566. 6.3.7           UK7
  1567.         Use this option when the host uses
  1568.         the English ISO 7 bit standard.
  1569.  
  1570. 6.3.8           GE7
  1571.         Use this option when the host uses
  1572.         the German ISO 7 bit standard.
  1573.  
  1574. 6.3.9           FR7
  1575.         Use this option when the host uses
  1576.         the French ISO 7 bit standard.
  1577.  
  1578. 6.3.10          SP7
  1579.         Use this option when the host uses
  1580.         the Spanish ISO 7 bit standard.
  1581.  
  1582. 6.3.11          IT7
  1583.         Use this option when the host uses
  1584.         the Italian ISO 7 bit standard.
  1585.  
  1586. 6.3.12          SF7
  1587.         Use  this  option when the host uses
  1588.         the Swedish/Finnish ISO 7 bit standard.
  1589.  
  1590. 6.3.13          DE7
  1591.         Use this option when the host uses
  1592.         the Danish ISO 7 bit standard.
  1593.  
  1594. 6.3.14        S87
  1595.         This character both receives IBM graphics and SF7 correctly
  1596.         (8-bits) but only sends SF7 (7-bits).
  1597.  
  1598. 6.4 DEL <-> BS
  1599.         Here  you may configure whether the backspace and del keys are
  1600.         to be exchanged.  This can be useful when communicating with a
  1601.         machine that runs Unix, VMS or Tops-20, amongst others.
  1602.  
  1603. 6.5 Show HEX chars
  1604.         This  option  will translate all incoming text to HEX numbers,
  1605.         as  well  as  displaying  the  text to the right.  Perfect for
  1606.         debugging.
  1607.  
  1608. 6.6 ANSI mouse
  1609.         If  this  option is turned on, mouse clicks will be translated
  1610.         into  ANSI  codes that move you to the current mouse position.
  1611.         The codes will be sent out to the serial port.
  1612.  
  1613.         If you only want to activate the NComm window without sending
  1614.         any ANSI codes, click in the NComm status window.
  1615.  
  1616. 6.7 ANSI capture
  1617.         ANSI escape codes will normally be filtered out when using the
  1618.         "ASCII capture" function.  Turn  this option on if you want to
  1619.         leave these codes untouched when doing an ASCII capture.
  1620.  
  1621. 6.8 Destructive Backspace
  1622.         Incoming  "backspace" codes will normally just move the cursor
  1623.         one  position  to  the  left.  Turn this option on if you want
  1624.         NComm to delete the character to the left of the cursor.
  1625.  
  1626. 6.9 Pad out blank lines
  1627.         Most  line editors used by bulletin boards enter the "command"
  1628.         prompt  when  RETURN  is  pressed  on  a  blank  line. This is
  1629.         normally not desirable when doing an "ASCII send".  By turning
  1630.         this option on,  NComm will always send a blank (SPACE) before
  1631.         sending  RETURN  on  a  new  line  when using the "ASCII send"
  1632.         function.
  1633.  
  1634. 6.10 Line Wrap
  1635.         If  this option has been turned off, text will not move to the
  1636.         next  line when hitting the right edge of the window.  This is
  1637.         according to the VT220 specs, so normally this function should
  1638.         be turned off.
  1639.  
  1640. 6.11 Line Editing
  1641.         If  this  option has been turned on, characters entered in the
  1642.         split  screen  window  can  be  edited with the backspace key.
  1643.         Nothing  will  be  sent  to  the  serial  port until you press
  1644.         carriage return.
  1645.  
  1646. CHAPTER 7: COMMANDS IN SCREEN MENU
  1647.  
  1648. 7.1  This  is  where  you  may  configure what your screen should look
  1649.      like.
  1650.  
  1651. 7.2  Title bar
  1652.         Toggles the title bar on and off
  1653.  
  1654. 7.3  ANSI Pens
  1655.         This  option  arranges  the screen pens so that NComm 3.0 will
  1656.         look as good as possible with the original NComm ANSI palette.
  1657.         The  palette may need a few modifications, though.  If you are
  1658.         using  a  normal  OS  2.0 palette, you should turn this option
  1659.         off for the best results.
  1660.  
  1661. 7.4  Screen mode
  1662.         When using 2.0 / 3.0, this menu brings up a standard 2.0
  1663.         screenmode requester that makes it possible to change the
  1664.         resolution used in NComm. If using 1.2 / 1.3, select one of
  1665.         the predefined resolutions from the submenu.
  1666.  
  1667.         If  you  choose  the eight colour mode, you will get full ANSI
  1668.         colour  emulation.   The  16  color mode will set up NComm for
  1669.         extended ANSI emulation, but will slow down the program a lot.
  1670.         See  chapter  5.2 for more information about this.  Choose the
  1671.         two or four colour mode if you prefer faster screen updates.
  1672.  
  1673. 7.5  Palette
  1674.         This  will  bring  up  a requester that lets you configure the
  1675.         colours for the current screen mode.  Each screen mode has its
  1676.         own  palette.  click 'RESET' to use the colours that NComm was
  1677.         shipped with.  To edit a color, click in the color box and use
  1678.         the slider gadgets.
  1679.  
  1680. 7.6  Split Screen
  1681.         This function will divide the screen into two windows, a small
  1682.         one  (  4 lines ) for your typed characters and a larger one (
  1683.         19  lines  when  using  NTSC) for characters received from the
  1684.         modem.
  1685.  
  1686.         You  should  select the half-duplex mode on the host system to
  1687.         prevent  your typed characters from being echoed back into the
  1688.         receive  window.  To exit the split screen mode, select 'Split
  1689.         Screen' from the menu again.
  1690.  
  1691.         Split  screen  mode requires at least 1MB of memory to operate
  1692.         in interlaced mode.
  1693.  
  1694.         Caution:
  1695.         If  you login to a system while in the split screen mode, your
  1696.         password will be echoed in the TX window.  It is best to login
  1697.         in the single screen mode.
  1698.  
  1699. 7.7  Style
  1700.         This  function allows you to turn on or off the translation of
  1701.         the  different  styles (boldface, italics and underline).  The
  1702.         reason  why  this function was included is that the styles are
  1703.         misused  by many bulletin board systems.  The text will appear
  1704.         clearer, and this will also reduce flashing when the screen is
  1705.         scrolling.
  1706.  
  1707. 7.8  Bell
  1708.         From  here  you  can  configure  what  NComm should do when it
  1709.         receives  the  ASCII  "bell"  code.   You can have an ordinary
  1710.         audible   bell   or   a   visible   bell.  You may even select
  1711.         'ScreenToFront',  which  will  bring the NComm screen to front
  1712.         when  the  "bell"  code  is  received.
  1713.  
  1714.         The  sample  option  makes it possible to play a standard 8SVX
  1715.         (IFF)  sound  sample  when  the bell code is received.  A file
  1716.         requester  will appear.  Select the sample you want to play.
  1717.  
  1718.         You  may  freely  mix  the four or turn bell off, but the beep
  1719.         and sample options may not be turned on simultaneously.
  1720.  
  1721. 7.9  Cursor blink
  1722.         Some  people  prefer  having  a blinking cursor, especially if
  1723.         they are used to the IBM Personal Computer. This function will
  1724.         try to emulate cursor blinking.
  1725.  
  1726. 7.10 Reset
  1727.         This  function  will  clear  the  screen,  turn  off all style
  1728.         settings and reset the colours.
  1729.  
  1730. 7.11 Workbench screen
  1731.         Use  this  function for placing NComm on the Workbench screen.
  1732.         This  will  also save a small amount of memory.
  1733.  
  1734. 7.12 Close Workbench screen.
  1735.          If you want to save a small amount of memory,  you may choose
  1736.          to close the Workbench screen with this function. Please note
  1737.          that no programs or Shell's can be open on the Workbench screen
  1738.          when this function is selected.
  1739.  
  1740. 7.13 Text Snapping
  1741.          (Only selectable if using OS 2/3) This function lets you snap
  1742.          text  from  the NComm terminal screen using the Right-Amiga-C
  1743.          key  combination.  Use  Right-Amiga-V for pasting text to the
  1744.          terminal screen.
  1745.  
  1746. 7.14 Force 80 x 24
  1747.         This option that forces a window that is 80 character wide and
  1748.         24  characters  high  (80  x 24).  Some bulletin board systems
  1749.         seem to require such a display.
  1750.  
  1751. 7.15 Flashing text
  1752.         If  this  option has been turned on, text will be displayed as
  1753.         "flashing"  if  ESC[5m  is  received.  If this option has been
  1754.         turned off, the text will be displayed in italics if the style
  1755.         command  has  been  turned  on.   This  function uses an extra
  1756.         bitplane  for  flashing the text so the text display will slow
  1757.         down a little when this function has been enabled.
  1758.  
  1759. 7.16 Custom Font
  1760.         This  menu  toggles the custom font option.  If toggled to the
  1761.         on  position,  a  font requester will appear.  Select the font
  1762.         you  would  like  to use with NComm.  You may want to turn the
  1763.         Line Wrap option off if you are using a large font.
  1764.  
  1765.         The  translation  menu still selects which type of translation
  1766.         that  should  be performed.  If you are using an IBM font, you
  1767.         should  normally  set the translation to ISO (no translation).
  1768.  
  1769. 7.17 Use WB Palette
  1770.         This option automatically gives you the same look in NComm (on
  1771.         a  custom  screen)  that you have on your WorkBench screen.  A
  1772.         nice  feature  is  that  you may grab and modify the WorkBench
  1773.         palette  by  entering  the  palette  requester and clicking on
  1774.         "OK".   If  you turn off the "WB Palette" option, the modified
  1775.         palette will be used.
  1776.  
  1777. 7.18 Public Screen
  1778.         This  option makes the NComm screen public.  The public screen
  1779.         name  is the same as the rexx port name, i.e.  "NComm" for the
  1780.         first  copy of NComm and "NComm_#" for additional copies (# is
  1781.         1  or more).  When selecting a Public Screen, NComm asks if it
  1782.         should  "Shanghai" windows.  If you turn this option on, NComm
  1783.         will  steel  any  windows  that  would  normally  open  on the
  1784.         Workbench screen.
  1785.  
  1786. 7.19            Window Gadgets
  1787.                 --------------
  1788.      The  screen contains hidden gadgets for depth arranging the NComm
  1789.      window.  The depth gadgets are in the upper right hand corner.
  1790.  
  1791.  
  1792. CHAPTER 8: COMMANDS IN PHONE MENU
  1793.  
  1794. 8.1  From   here  you  may  dial  phonenumbers,  edit  the  phonebook,
  1795.      configure the modem and redial, or hang up the phone.
  1796.  
  1797. 8.2 Phonebook
  1798.         This  entry  will bring up the phonebook window, where you may
  1799.         load  or  save  phonebooks,  as  well  as edit, delete and add
  1800.         entries.  The  entries can also be sorted, dialled or printed.
  1801.  
  1802.         When   loaded,   NComm   first   looks   for   a  file  called
  1803.         NComm:NComm.phone.  If not found, the phonebook will be blank.
  1804.  
  1805.         The  phonebook  can consist of an unlimited number of entries,
  1806.         but  only the first 46 will be displayed in the DIAL menu, and
  1807.         only the first 10 can be dialled using hot keys.
  1808.  
  1809.         Only 15 entries can be displayed simultaneously in the window.
  1810.         To scroll through the phonebook, use the right drag bar.
  1811.  
  1812.         You  may select an entry by positioning the  pointer  over  it
  1813.         and then clicking  on the  left mouse button. When an entry is
  1814.         selected,  it  will show up in reverse video.  Several entries
  1815.         can be selected at the same time.
  1816.  
  1817. 8.2.1   Selecting  the  'Dial!'  gadget will dial the entries that are
  1818.         selected,  starting  at  the  top.  This will bring up a small
  1819.         window telling you which board you are calling, and eventually
  1820.         which  is  the  next  to  go.   The  phonebook  window will be
  1821.         removed.    More  entries  can  be  added  while  dialling  by
  1822.         selecting  them  from  the  DIAL  menu,  or by bringing up the
  1823.         phonebook again.
  1824.  
  1825.         If  a  number is busy, the program will continue with the next
  1826.         number  on the list.  If redial has been turned on, NComm will
  1827.         start  over  again if no connection has been established or an
  1828.         "invalid"  result  code is received (this depends on the 'Max'
  1829.         settings  in  the  modem setup menu.  The default action is to
  1830.         abort when an error code is received.)
  1831.  
  1832.         Abort  the  dialling  by  pressing  the ESC key or closing the
  1833.         window  by  clicking  in the upper lefthand gadget.  To remove
  1834.         the  current entry, press the DEL key.  Press the SPACE key if
  1835.         you would like to go on with the  next  entry.  You  may  also
  1836.         click within the window gadgets.
  1837.  
  1838. 8.2.2   Selecting  the  'Edit'  gadget  will bring up the edit window,
  1839.         containing  the  information  about  the first entry selected.
  1840.         This  information  can  then  be  edited.   See below for more
  1841.         information  about  how  to use the edit window.  Pressing the
  1842.         'OK'  gadget  will  accept the edit and display the next entry
  1843.         that  is  selected  (if  any),  'Cancel' will leave everything
  1844.         unchanged.
  1845.  
  1846.         Please note that you may click in the select window while the
  1847.         edit  window is open if you want to keep the changes (if any)
  1848.         and move to a different entry.  It is highly recommended that
  1849.         NComm  is  set to use overscan width if you want both windows
  1850.         to  be  completely  visible at the same time.  Otherwise, the
  1851.         windows  will  overlap. You may also double-click on an entry
  1852.         in the select window if you want to bring up the edit window.
  1853.  
  1854. 8.2.3   Selecting  the  'New'  gadget will add a new entry in front of
  1855.         the  first  entry  selected.   However,  if  no entry has been
  1856.         selected,  the entry will be placed at the bottom of the list.
  1857.         This  will bring up a special edit window  that  contains  the
  1858.         current  NComm settings.  See below for more information about
  1859.         how to use the edit window.  Pressing the 'OK' gadget will add
  1860.         the  current  entry,  'Cancel' will abort the edit and not add
  1861.         the entry.
  1862.  
  1863. 8.2.4   The 'Swap' command  swaps to entries. click on two entries and
  1864.         then on 'Swap' if you want them to change place.
  1865.  
  1866. 8.2.5   Selecting  the 'Load' gadget will bring up a file requester in
  1867.         the  center  of  the  screen.   For instructions on how to use
  1868.         this, see "The file input-requester" above.  From here you may
  1869.         load  a new phonebook.  Remember to save the current phonebook
  1870.         if  any  changes  have been made.  Entering "NComm.phone" will
  1871.         load the phonebook that is normally loaded at startup.
  1872.  
  1873. 8.2.6   Selecting  the 'Save' gadget will bring up a file requester in
  1874.         the  center  of  the  screen.   For instructions on how to use
  1875.         this, see "The file input-requester" above.  From here you may
  1876.         save  the  current phonebook.  Enter the name "NComm.phone" if
  1877.         you want the phonebook to be loaded at startup.
  1878.  
  1879. 8.2.7   Selecting the 'Delete' gadget will delete the entries that are
  1880.         currently selected.
  1881.  
  1882. 8.2.8   Selecting  the  'Sort'  gadget  will sort the phonebook.  If a
  1883.         entry  has  been  selected,  the  function  will only sort the
  1884.         entries between this entry and down.  If multiple entries have
  1885.         been selected, the function will only sort the entries between
  1886.         the top and lower entry.
  1887.  
  1888.         This  can  be handy if you are using hot keys to dial numbers,
  1889.         and  don't  want the upper entries mixed with entries that are
  1890.         lower  on  the  list, or if you prefer using the DIAL menu for
  1891.         dialling  entries and don't want entry 45 and down to be mixed
  1892.         with the upper entries.
  1893.  
  1894. 8.2.9   Selecting  the  'Print' gadget will print the phonebook. Enter
  1895.         the name of the file in the  righthand  text  gadget,  or  use
  1896.         "PRT:" if you want output sent to the printer. If  no  entries
  1897.         are selected, the whole phonebook will be printed. Else,  only
  1898.         the entries selected will be printed.
  1899.  
  1900. 8.2.10  The  'Clr/Mark'  gadget is a combined "Mark All" / "Clear All"
  1901.         function.   If  any  entries have been selected, this function
  1902.         will  deselect all entries.  If no entries have been selected,
  1903.         this function will mark all entries.
  1904.  
  1905. 8.3 Dial #
  1906.         This  requester  will dial a number which is not listed in the
  1907.         phonebook.  If redial has been turned on, the program will try
  1908.         reaching  the  number until connection has been established or
  1909.         an  "invalid"  result  code  is  received (this depends on the
  1910.         'Max' settings in the modem setup menu.  The default action is
  1911.         to abort when an error code is received.) This function can be
  1912.         used  together with the dial queue.  If you want to enter more
  1913.         than one number, seperate the numbers with a '|'...
  1914.  
  1915.         If the traplist.library is available in your LIBS:  directory,
  1916.         you  may  enter  a  nodenumber  f.ex.  "2:502/15" instead of a
  1917.         number.   NComm will automatically look for the number in your
  1918.         traplist file.
  1919.  
  1920. 8.4 Hang up
  1921.         Selecting  this  entry  will send the HANGUP command string to
  1922.         the modem (or lower DTR if DTR-hangup has been selected).
  1923.  
  1924. 8.5 Redial
  1925.         By configuring this option, NComm will try over and over again
  1926.         when a board you are calling is busy. This setting may however
  1927.         be overridden by the 'Max Busy' field in the modem setup menu.
  1928.         NComm  will  then abort the redial if it reaches the specified
  1929.         number of 'Busy' messages.
  1930.  
  1931. 8.6 Modem setup
  1932.         Within  this  requester  you may configure the things that are
  1933.         sent and received by the modem, and how long NComm should wait
  1934.         before  redialling.   Simply click in the text gadgets to edit
  1935.         them. The  setup  strings  can  contain the control characters
  1936.         listed under the explanation of 'macrokeys'. Most text gadgets
  1937.         have  a  "Max"  field  that  adjusts NComm's toleranse for the
  1938.         codes.
  1939.  
  1940. 8.6.1   The  'initialization  string'  will  be sent to the modem soon
  1941.         after  NComm opens the serial device and before keyboard input
  1942.         is  accepted.   It  can be left blank, but remember that NComm
  1943.         requires  'echo'  from  the  modem,  so  it  can  be clever to
  1944.         configure  this here.  This can be accomplished by the 'AT E1'
  1945.         command if your modem is Hayes compatible.
  1946.  
  1947.         You  must  also set your modem to detect the BUSY signal if it
  1948.         has got such a feature.  If you have problems configuring your
  1949.         modem,  the 'AT &F\n' line will load the factory configuration
  1950.         on  Hayes compatibles.  This configuration is usually accepted
  1951.         by NComm.
  1952.  
  1953. 8.6.2   The  'exit  string'  is  sent just before the serial device is
  1954.         closed, when exiting NComm.  It is normally left blank.
  1955.  
  1956. 8.6.3   'Dial  cmd'  is   the  command  to  be  inserted   before  the
  1957.         phone number.  For  Hayestype  modems, this should be ATDT (or
  1958.         ATDP  for  pulse  dial).  NComm  supports  four different dial
  1959.         prefixes  in  case  the  modem must be set up differently when
  1960.         calling  various bulletin  boards.  These can be selected from
  1961.         from  the  phone book. When dialling an unlisted number, NComm
  1962.         will always use the first dial cmd.
  1963.  
  1964. 8.6.4   'Dial suffix' is the string to be added after the phonenumber.
  1965.         For  Hayestype  modems, this should be '\n', which will send a
  1966.         carriage return.
  1967.  
  1968. 8.6.5   'Hang-up  string' is the string to be sent when you choose the
  1969.         Hangup   function.   For  Hayestype  modems,  this  should  be
  1970.         '\w\w+++\w\w\w\wATH\n'  (Wait  1 sec  +++  Wait 2 sec ATH CR).
  1971.         This code is ignored if you are using the DTR-hangup option.
  1972.  
  1973. 8.6.6   The  'connect  string'  is the string sent from the modem when
  1974.         you  get  connected  to  a  board.  For Hayestype modems, this
  1975.         string  should  be  'CONNECT'. This code is ignored if you are
  1976.         using hardware CARRIER detection.
  1977.  
  1978. 8.6.7   The 'disconnect string' is the string sent from the modem when
  1979.         a  call  has ended.  This string is also sent if the modem was
  1980.         not able to establish a connection with the remote modem.  For
  1981.         Hayestype modems, this should be 'NO CARRIER'.
  1982.  
  1983.         The "Max NoCarrier" field defines how many NO CARRIER messages
  1984.         that  are  accepted  by NComm before it removes the entry from
  1985.         the  dial  queue.   If  the max field is set to zero (0) NComm
  1986.         will  not  remove  the  entry from the list but dials the next
  1987.         number  instead.   Otherwise  NComm will remove the entry from
  1988.         the  dial  queue after  x NO CARRIER messages (x is the number
  1989.         specified in the gadget).
  1990.  
  1991. 8.6.8   The  'busy  string' is the string sent from the modem when the
  1992.         phone  is  busy.   For  Hayestype modems this string should be
  1993.         'BUSY',  but  if  your  modem is having problems detecting the
  1994.         busy signal, enter this as 'NO CARRIER'.
  1995.  
  1996.         The  "Max  Busy" field defines how many BUSY messages that are
  1997.         accepted  by  NComm  before aborting the dialling.  If the max
  1998.         field  is  set to zero (0) NComm will always continue and dial
  1999.         the  next  entry.   Otherwise  NComm will abort redial after x
  2000.         BUSY messages (x is the number specified in the gadget).
  2001.  
  2002. 8.6.9   The  'voice  string'  is the string sent from the modem when a
  2003.         voice  answers  the  phone  in  the  other end.  For hayestype
  2004.         modems this string should be 'VOICE'.
  2005.  
  2006.         The "Max Voice" field defines how many VOICE messages that are
  2007.         accepted  by  NComm  before  it aborts dialling or removes the
  2008.         entry  from  the  list.   If  the max field is set to zero (0)
  2009.         NComm will abort immediately.  Otherwise NComm will remove the
  2010.         entry  from  the  dial  queue after x VOICE messages (x is the
  2011.         number specified in the gadget).
  2012.  
  2013. 8.6.10  The  'no  dialtone  string'  is the string sent from the modem
  2014.         when  the  modem  is  not  able  to  call out due to a missing
  2015.         dialtone.   For  hayestype  modems  this  string should be 'NO
  2016.         DIALTONE' but some modems return 'NO DIAL TONE' instead.
  2017.  
  2018.         The  "Max  NoDialtone"  field  defines  how  many  NO DIALTONE
  2019.         messages that are accepted by NComm before it aborts dialling.
  2020.         If  the  max  field  is  set  to  zero  (0)  NComm  will abort
  2021.         immediately.   Otherwise  NComm will abort dialling after x NO
  2022.         DIALTONE messages (x is the number specified in the gadget).
  2023.  
  2024. 8.6.11  The  'error  string' is the string sent from the modem when it
  2025.         receives an invalid command.  For hayestype modems this string
  2026.         should be 'ERROR'.
  2027.  
  2028.         The "Max Error" field defines how many ERROR messages that are
  2029.         accepted by NComm before it aborts dialling.  If the max field
  2030.         is  set  to  zero (0) NComm will abort immediately.  Otherwise
  2031.         NComm  will  abort  dialling  after x ERROR messages (x is the
  2032.         number specified in the gadget).
  2033.  
  2034. 8.6.12  The  'ringing  string'  is the string sent from the modem when
  2035.         the  phone  in  the  other  end  of  the line is ringing.  For
  2036.         Hayestype  modems  this  string  should  be 'RINGING' but some
  2037.         modems  also  return  'RING'  when the phone is ringing in the
  2038.         other end.
  2039.  
  2040.         The "Max Ringing" field defines how many RINGING messages that
  2041.         are  accepted by NComm before it dials the next entry.  If the
  2042.         max  field is set to zero (0) NComm will wait continuously for
  2043.         CONNECT.   Otherwise  NComm  will  dial the next entry after x
  2044.         RINGING messages (x is the number specified in the gadget).
  2045.  
  2046. 8.6.13  The  'no answer string' is the string sent from the modem when
  2047.         the  modem  in  the  other  end did not answer the phone.  For
  2048.         hayestype modems this string should be 'NO ANSWER'.
  2049.  
  2050.         The  "Max  NoAnswer" field defines how many NO ANSWER messages
  2051.         that  are  accepted  by NComm before it removes the entry from
  2052.         the  dial  queue.   If  the max field is set to zero (0) NComm
  2053.         will  not  remove  the  entry from the list but dials the next
  2054.         number  instead.   Otherwise  NComm will remove the entry from
  2055.         the  dial  queue  after  x NO ANSWER messages (x is the number
  2056.         specified in the gadget).
  2057.  
  2058. 8.6.14  The  'remote  ring  string'  is the string sent from the modem
  2059.         when  a person in the other end is calling you.  For hayestype
  2060.         modems   this  string  should  be  'RING\r\n'.   NComm  aborts
  2061.         dialling immediately when this message is received.
  2062.  
  2063. 8.6.15  The  'delayed string' is the string sent from the modem when a
  2064.     called is delayed due to the blacklist feature in some modems.
  2065.     This string should normally be "DELAYED".
  2066.  
  2067.         The "Max Delayed" field defines how many DELAYED messages that
  2068.         are  accepted  by  NComm before aborting the dialling.  If the
  2069.         max  field  is  set to zero (0) NComm will always continue and
  2070.         dial  the next entry.  Otherwise NComm will abort redial after
  2071.         x DELAYED messages (x is the number specified in the gadget).
  2072.  
  2073.         Do also try to turn on the "Avoid Blacklist" feature. This may
  2074.         prevent this message from showing up.
  2075.  
  2076. 8.6.16  In  the  'delay'  box  you  may specify how many seconds NComm
  2077.         should  wait  before  dialling the next number.  This delay is
  2078.         normally  set  to  '3',  but  enter  '0'  if  you have entered
  2079.         'NO CARRIER' as a BUSY string.
  2080.  
  2081. 8.6.17  If the  Use Locked Rate option has been turned off, NComm will
  2082.         look  for  the  number  specified  right  after  the 'CONNECT'
  2083.         message,  and  will  switch  to  that  speed.  Turn the locked
  2084.         baud-rate  option  on if you have set a constant speed between
  2085.         the  modem  and  the  machine,  or if you are certain that the
  2086.         hostmodem  supports  the  speed that you are calling at.
  2087.  
  2088.         I.e,  turn  the locked rate option on if you are using a modem
  2089.         that  has  been  set  up for use with locked baud rates (speed
  2090.         buffering).   If  you  have  turned  locked  rate  off,  it is
  2091.         important that you have told your modem to report the baudrate
  2092.         sent  after  the  'CONNECT'  message.   This is done, again on
  2093.         Hayes, with the command 'AT V1 X2'.
  2094.  
  2095. 8.6.18  Drop-DTR Hangup will cause a drop of the DTR signal for a few
  2096.         seconds when the hangup function is selected. This function is
  2097.         meant  to  be  used  with dumb modems (modems that do not have
  2098.         some sort of a command language).
  2099.  
  2100. 8.6.19  In the 'loop delay' box you may specify how many seconds NComm
  2101.         should wait before repeating the dial loop. If set to '0', the
  2102.         normal delay value will be used when repeating the loop.
  2103.  
  2104. 8.6.20  The  'Hard-DCD  Checking' option switches the hardware CARRIER
  2105.         detect option on or off.  The hardware method is more reliable
  2106.         than just looking for the NO CARRIER string (if it shows up in
  2107.         a message, NComm will assume that the call has ended).
  2108.  
  2109.         NOTE:   Your  modem  must track TRUE CARRIER.  This means that
  2110.         the DCD signal must be "low" (off) in command state and should
  2111.         not go "high" (on) until a connection has been established.
  2112.  
  2113. 8.6.21  The  'Ignore echo' option turns off the "Modem not responding"
  2114.         checking.   Note:   Normally  this  is a fatal error and means
  2115.         that  your  modem did not respond to the command that was sent
  2116.         by  NComm.  Please check your complete modem setup rather than
  2117.         just turning off this option.
  2118.  
  2119. 8.6.22  The  'Avoid Blacklist' option will do its best to avoid black-
  2120.         listing  of  telephone  numbers,  an  unwanted feature that is
  2121.         implemented  in  most  norwegian  (and  probably some foreign)
  2122.         modems.   If  your modem spits out "DELAYED" and "BLACKLISTED"
  2123.         messages,  you  may  try  turning this option on.  Please note
  2124.         that  this option will only work with some telephone centrals.
  2125.         However, it does absolutely nothing illegal or dangerous...
  2126.  
  2127. 8.6.23  Pressing  the  'OK' gadget will accept the edit, 'Cancel' will
  2128.         leave everything unchanged.
  2129.  
  2130. 8.7     Redial at logoff
  2131.         ----------------
  2132.         If  this  option  if  turned on, NComm will start dialling the
  2133.         rest  of  the  boards that are selected in the phonebook after
  2134.         logging  out  from  the  current  system.  NComm automatically
  2135.         deselects boards in the PhoneBook when you connect to them.
  2136.  
  2137. 8.8     Edit window
  2138.         -----------
  2139.         The  edit  window  contains seven text  input  boxes and eight
  2140.         gadgets.
  2141.  
  2142. 8.8.1   In  the  text  input  box marked 'Name', enter the name of the
  2143.         board.
  2144.  
  2145.         The  name  can  be up to 40 characters long, however, only the
  2146.         first  17  characters  will  be displayed in the dial menu and
  2147.         window, and in the logfile.  You can not leave this empty.
  2148.  
  2149. 8.8.2   In  the text input box marked 'Phone #', enter the phonenumber
  2150.         to  the current board.  The phonenumber can be up to 60 digits
  2151.         long.   If  a board has multiple numbers, enter them separated
  2152.         by  the  '|' character, for example "416588|410403".  Only the
  2153.         first  17 characters will be displayed in the dial window, and
  2154.         in the logfile.  This field can not be omitted.
  2155.  
  2156.         If  traplist.library  is available in your LIBS: directory you
  2157.         may enter a FIDO nodenumber instead of the phonenumber.
  2158.  
  2159. 8.8.3   In  the  text  input  box  marked 'Comment', enter an optional
  2160.         comment,  like  when  the board is open, what the main purpose
  2161.         with  the  board  is,  if MNP is available or which speeds are
  2162.         available.  The comment can be 40 characters long.
  2163.  
  2164. 8.8.4   In  the  text  input  box marked 'Config', you may specify the
  2165.         name  of  an  optional  configuration  file.   The filename is
  2166.         relative  to  the  current  directory.  It will be loaded just
  2167.         after  dialling.   The  colors,  screen mode and menu settings
  2168.         will   be   changed  back  to  the  way  they  were  when  the
  2169.         configuration  file  was  saved.   The phonebook settings have
  2170.         higher  priority  than the settings found in the configuration
  2171.         file.
  2172.  
  2173. 8.8.5   In  the  text  input  box marked 'Macros', you may specify the
  2174.         name  of an optional macrokeys file.  The filename is relative
  2175.         to  the  current  directory.   It  will  be  loaded just after
  2176.         dialling.
  2177.  
  2178. 8.8.6   In  the  text  input  box marked 'Script', you may specify the
  2179.         name  of  an optional scriptfile.  The filename is relative to
  2180.         the  current  directory.   It will be loaded and executed just
  2181.         after  dialling,  which  means  that the scriptfile should NOT
  2182.         contain the 'dial' command as the first entry.
  2183.  
  2184. 8.8.7   In  the  text  input  box  marked 'ARexx', you may specify the
  2185.         name  of  an  optional arexxfile.  The filename is relative to
  2186.         the  current  directory.   It will be loaded and executed just
  2187.         after  dialling,  which  means  that the scriptfile should NOT
  2188.         contain the 'dial' command as the first entry.
  2189.  
  2190. 8.8.8   In  the text input box marked 'Username', you may specify your
  2191.         username  on this board.  This can be handy if you prefer only
  2192.         using  one scriptfile for multiple boards.  The scriptfile can
  2193.         then  contain  a  'SEND  "\u\n"'  command  line that sends the
  2194.         username  configured  for the current board.  The username can
  2195.         also be sent by configuring '\u\n' on one of the macrokeys.
  2196.  
  2197. 8.8.9   In  the  text input box marked 'Password', you may specify the
  2198.         name of an optional password.  This can be handy if you prefer
  2199.         only using one scriptfile for multiple boards.  The scriptfile
  2200.         can  then  contain a 'SEND "\p\n"' command line that sends the
  2201.         password  configured  for the current board.  The password can
  2202.         also be sent by configuring '\p\n' on one of the macrokeys.
  2203.  
  2204.         Pressing  'return'  in  one of the text input boxes will bring
  2205.         the  cursor  to the text input box below the current box.  The
  2206.         cursor  will  be  brought to the top if 'return' is pressed in
  2207.         the bottom box.
  2208.  
  2209. 8.8.10  Pressing the gadget marked 'Baud rate' will multiply the board
  2210.         rate which is to be used for the board by two.  However, since
  2211.         NComm only  supports  board  rates up to 115200 baud, the baud
  2212.         rate will revert to 300 baud when this baudrate is present.
  2213.  
  2214. 8.8.11  Pressing the gadget marked 'Data length' will switch between 7
  2215.         and  8  bits  data length.  This data length will be used when
  2216.         NComm dials the board.
  2217.  
  2218. 8.8.12  Pressing  the gadget marked 'Parity' will switch between Even,
  2219.         Odd,  Mark,  Space  and None parity.  This parity will be used
  2220.         when NComm dials the board.
  2221.  
  2222. 8.8.13  Pressing  the  gadget marked 'Stop bits' will switch between 1
  2223.         and  2  stop bits.  This number of stop bits will be used when
  2224.         NComm dials the board.
  2225.  
  2226. 8.8.14  Pressing  the  gadget marked 'Duplex mode' will switch between
  2227.         Full  and  Half  duplex.   This  duplex mode will be used when
  2228.         connection is established.
  2229.  
  2230. 8.8.15  Pressing the gadget marked 'Character set' will switch between
  2231.         IBN, IBP, US7, UK7, GE7, FR7, SP7, IT7, DE7, NO7, SF7, ISO and
  2232.         IBM  translation.   If  the  IBM or IBN character set has been
  2233.         chosen,  a special IBM graphics font will be used.  ISO should
  2234.         be  used  for  Amiga  boards  only.   The other character sets
  2235.         should  be  used on machines only having a 7-bit character set
  2236.         available.    By   watching  the  first  two  letters  in  the
  2237.         translation  name,  you may easily find out which one is to be
  2238.         used  for  your country.  This character set will be used when
  2239.         connection is established.
  2240.  
  2241. 8.8.16  The 'Swap Del/BS' option will (when turned on) swap the Delete
  2242.         and Backspace key as soon as you connect to this board.
  2243.  
  2244. 8.8.17  By pressing the gadget marked  'Xfer protocol', you may choose
  2245.         the protocol for use with this board.  Available protocols are
  2246.         Xmodem,   Ymodem,   Ymodem-Batch,  Ymodem-G,  Zmodem, Kermit,
  2247.         Bimodem, Bmodem Plus, Compuserve-B, Jmodem, VMS, Uue-Ascii or
  2248.         "External XPR"  (as configured  in  the  configuration  file).
  2249.  
  2250. 8.8.18  The  'Show  in  menu'  selector specifies if this entry should
  2251.         show  up  in  the  quick dial menu.  This makes it possible to
  2252.         keep  the  phonebook  sorted  and  at  the  same time mask out
  2253.         entries that are rarely dialled from the dial menu...
  2254.  
  2255. 8.8.19  By pressing the 'Dial Cmd' gadget, you may select which prefix
  2256.         that  should  be  used when dialling this board.  The prefixes
  2257.         are defined in the modem setup requester.
  2258.  
  2259. 8.8.20  The date at the bottom of the window shows when the board was
  2260.         last  dialled.  The  number  in  the paranthes shows how many
  2261.         times you have logged on to the board.  This information will
  2262.         only  be  logged if you  have  turned on the "Log Phone Info"
  2263.         option...
  2264.  
  2265. 8.9     PB Password
  2266.         -----------
  2267.         If  you  turn  this  option on, NComm will ask for a password.
  2268.         The  password  you specify must be entered every time you want
  2269.         to  reload the phonebook.  All passwords in the phonebook will
  2270.         be encoded to illegible gibberish. Note: Blanks will be echoed
  2271.         when asked to verify the password.
  2272.  
  2273. CHAPTER 9: INFORMATION ABOUT DIAL MENU
  2274.  
  2275.      Use  this  menu  for  fast  dialling of entries in the phonebook.
  2276.      Simply choose the board you would like to dial from the menu.
  2277.  
  2278.      Choosing  a  entry will bring up a small window telling you which
  2279.      board  you  are calling.  From here you may add more entries from
  2280.      the  menu, and set up a dial queue.  The window will at all times
  2281.      tell  you  which board is the next to dial. Boards that are added
  2282.      to  the   queue  will  automatically  become  "selected"  in  the
  2283.      phonebook.
  2284.  
  2285.      If  a  number  is  busy,  the program will continue with the next
  2286.      board  on  the  list.   If  redial has been turned on, NComm will
  2287.      start  over  again if no connection has been established with any
  2288.      of  the  boards  in  the  queue.  It will not stop until either a
  2289.      connection  has  been  established or an "invalid" result code is
  2290.      received  (this  depends on the 'Max' settings in the modem setup
  2291.      menu.   The  default  action  is  to  abort when an error code is
  2292.      received.)
  2293.  
  2294.      NComm  will  abort  the dialling if it receives any text from the
  2295.      modem during the redial delay.
  2296.  
  2297.      Abort  the dialling by pressing the ESC key or closing the window
  2298.      by  clicking  in  the  upper lefthand closegadget.  To remove the
  2299.      current  entry,  press  the  DEL key.  Press the SPACE key if you
  2300.      would  like  to  go  on  with the next entry.  You may also click
  2301.      within the window gadgets.
  2302.  
  2303.      NOTE:   If you select an entry from the dial menu while currently
  2304.      being  online,  the  entry will become selected in the phonebook.
  2305.      The  entry  will  be automatically be dialled after logoff if the
  2306.      "redial after logoff" option has been turned on.
  2307.  
  2308. CHAPTER 10: HOT KEYS AVAILABLE
  2309.  
  2310.      Are  you  fed  up  with  menus and mice and want to use something
  2311.      quicker  instead?   Look  no  further - NComm offers hot keys for
  2312.      most important functions.
  2313.  
  2314.      Hot Key                 Function
  2315.      -------                 --------
  2316.  
  2317.      Right Amiga A          About NComm
  2318.      Right Amiga B          Sends a 250ms break signal
  2319.      Right Amiga C          Copy block to clipboard (Text Snapping)
  2320.      Right Amiga D          Download
  2321.      Right Amiga E          Edit phonebook
  2322.      Right Amiga F          Execute script file on/off
  2323.      Right Amiga G          Palette
  2324.      Right Amiga H          Hang up phone
  2325.      Right Amiga I          Select ScreenMode
  2326.      Right Amiga J          Start/end ASCII Capture
  2327.      Right Amiga K          Split screen
  2328.      Right Amiga L          Load configuration
  2329.      Right Amiga M          Macrokeys
  2330.      Right Amiga N          Dial number
  2331.      Right Amiga O          Modem set-up
  2332.      Right Amiga P          Printer on/off
  2333.      Right Amiga Q          Quit NComm
  2334.      Right Amiga R          Reset
  2335.      Right Amiga S          Start/end ASCII Send
  2336.      Right Amiga T          Toggle title bar
  2337.      Right Amiga U          Upload
  2338.      Right Amiga V          Paste block in clipboard
  2339.      Right Amiga W          Save configuration
  2340.      Right Amiga Y          Message upload
  2341.      Right Amiga Z          New Shell
  2342.  
  2343.      Right Amiga $          Run ARexx Script
  2344.      Right Amiga `          View scrollback
  2345.      Right Amiga !          Save scrollback
  2346.      Right Amiga %          Toggle Workbench Screen
  2347.      Right Amiga ^          Toggle Text Snapping
  2348.      Right Amiga *          Toggle 80 * 24 Mode
  2349.      Right Amiga \          Toggle/Select Custom Font
  2350.      Right Amiga =          Toggle Public Screen
  2351.      Right Amiga /          (Reserved for future expansion)
  2352.  
  2353.      Right Amiga #          (# is one of the keys 1,2,3,4,5,6,7,8,9,0)
  2354.                             This  sequence  will dial one of the first
  2355.                             10 entries in the phone directory.
  2356.  
  2357.      HELP key               Status
  2358.  
  2359.      The  CONTINUE  and  APPEND  options can be answered with the LEFT
  2360.      AMIGA  V key.  The CANCEL and DELETE options can be answered with
  2361.      the  LEFT  AMIGA  B  key.  You can of course click the left mouse
  2362.      button over these selections as well.
  2363.